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PREFACE 

This manual describes how to use the Multiprogramming Monitor version 1 . 
The distinguishing feature of this version is that all users' programs together 
must fit within the limits of core memory and are prevented from interfering 
with each other by hardware and with each other's I/O by software. Also, 
DECtope is the principal storage medium for users' files. 

As future versions of the monitor are developed, inevitably corresponding 
changes will be made in existing users' programs, both to take advantage of 
newly added features and to make corrections where an old feature was changed, 
Therefore, it is recommended that the monitor- and l/O-interface portion of 
the user's program be written as a separate program so that it may be updated 
easily. Every effort will be made to keep such changes to a minimum. 
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CHAPTER 1 

INTRODUCTION TO THE PDP-6 MULTI PROG RAM MED 
TIME-SHARING SYSTEM 

The Programmed Data Processor-6 time-sharing system provides integrated software and hardware for the 
simultaneous use of a single system by many users at Teletype consoles. A user may obtain the use of all 
system facilities and programs from a remote location. Users' programs and data are kept on a separate 
DECtape for each user to permit permanent storage of results. 

A user may start one or more active programs called jobs. Each job is console initiated and runs in an 
assigned and protected memory area. 

BASIC SYSTEM FEATURES 
The basic system objective is to provide a simple, modular, time-sharing system. 

File Generation - A user may create and edit a text file directly from his time-sharing console. The need 
for off-line program preparation devices (key punches, paper tape perforators) is greatly reduced. 

On-line Debugging - A user may debug his program on-line through an advanced debugging program 
(DDT) . Corrections can be made and tested instantly. On-line debugging is feasible because a user can- 
not tie up the entire installation while he stops to decide what to do next. 

Common User Service Programs (CUSPS) - Commonly used programs, such as the compiler, the assembler, 
and file manipulation programs, are available to all users. New programs of general interest are easily 
made available to all users. 

Unattended Batch Processing - The user may call for a special user program called the Batch Control 
Processor (BCP) which then takes over the supervision of his job in a manner similar to conventional batch 
processing systems. 

Special Console Service - The executive subroutines may be modified so that installations requiring a 
special service or language may be included. 

Real Time Processing - The necessary input/output routines to connect a special device with the program^ 
ming system can be added. A job could then issue system input/output commands for the special device 
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in a similar manner as for conventional devices. In some applications, it would be necessary to modify 
the schedular portion of the monitor so that occurrence of I/O device conditions would cause special 
service for the user. 

Common I/O Service - I/O service routines within the monitor provide a basic set of input/output commqnds. 
Programs are easily written which communicate with many I/O devices using identical commands for each 
device. All I/O subroutines use the hardware priority interrupt system so that the monitor never waits for 
data transmission. 

Common System Service - Monitor routines, at the request of a user program, perform special system func- 
tions such as giving the time, date, and job reinitializing. 

HARDWARE REQUIREMENTS 
The following is the minimum hardware configuration to allow multiprogrammed time sharing. 

1-166 Arithmetic Processor with 626 Teleprinter 

1-161C (or 163C) 1 6384-Word Core Memory 

1-136 Data Control 

1-551 DECtape Control 

1-555 Dual DECtape Transport (2 drives) 

1-760 Paper Tape Reader (for maintenance programs) 

In addition to the above hardware, one Type 162 16- Word Fast Memory and any number of additional 
Type 161C (or 163C) Core Memories (up to a total of 262,144 words) may be added to the system without 
requiring any modifications to system software. 

Optional Hardware with Software Support 

With very minor modifications to system software, the standard Time-Sharing Monitor can handle any con- 
figuration that contains the following devices: 

1-630 Data Communications System with up to 64 half- or full-duplex 

8-level teletypev/riters 

4-555 Dual DECtape Transports (up to 8 drives) 

1-516 Magnetic Tape Control with up to 8 Magnetic Tape Transports 

Type 50, Type 570, or IBM Type 729 (any model) 
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1-346 Incremental Display (with optional light pen and character 

generator) 

1 -461 Card Reader (200 or 800 cpm) 

1-646 Line Printer (300, 600 or 1000 Ipm) 

1-761 Paper Tape Punch 
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CHAPTER 2 



MULTIPROGRAMMING SYSTEM BLOCK DIAGRAM DISCUSSION 



Figure 2-1, the Multiprogramming System Block Diagram, depicts the flow of data to the user consoles 
and external files, and the software-hardware interaction. 
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Figure 2-1 Multiprogramming System Block Diagram 

USER CONSOLES 

As shown in the system block diagram, a user's console is either the console Teletype at the computer or 
one of 64 Teletypes at (possibly) remote locations connected to the computer via the data communications 
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system. The console is a user's communication with the multiprogramming system and with his files. All 
the commands necessary for starting and controlling a job are made via this console; system responses and 
error messages are printed on the user's console. Also, the console is useful for entering data and receiv- 
ing results. 

Teletype stations connect to the data communications system through standard TWX lines or direct wire. 
Characters are processed sequentially as they arrive according to one of several schemes as selected by 
the operating program. Characters are transmitted to the user's program a character at a time, a line at 
a time, or a full buffer (95 characters) at a time, 

A user's console has three states; the detached state, the monitor state, and the user state. The detached 
state exists whenever the console is idle. If a user types a legitimate monitor command on the detached 
console, the monitor automatically assigns a free job number to the console and places the console in the 
monitor state. In this state, the monitor interprets characters typed in as monitor commands. Certain 
monitor commands start the user's program running and simultaneously place the console in the user state 
so that characters typed in are processed by the user's program and not by the monitor. Certain error con- 
ditions or typing the proper control character (C with the control key held down) cause the monitor to 
return the console to the monitor state. Certain other monitor commands return the console to the detached 
state (DETACH and KJ OB - kill job). 

MULTIPROGRAMMING EXECUTIVE FUNCTIONS 

The multiprogramming system consists of routines to allocate resources (core storage, arithmetic processor 
time, I/O devices) among the various users and routines to perform input/output. The resource-allocation 
portion is called the exec or the monitor. Also included in the exec are routines to perform such book- 
keeping operations as timing the user program or supplying the date on request. 

The monitor and l/O routines form a collection of programs that are permanently in core memory during 
time-shared operation. The monitor makes use of the PDP-6 time-sharing hardware to load several users' 
programs into core memory simultaneously and to prevent each user's program from interfering with any 
other. If more than one user requests that his program be run, the monitor switches control to each pro- 
gram in a round-robin fashion. Switching is rapid so that all programs appear to run simultaneously. If a 
user's program must wait for the completion of an input/output operation, the monitor immediately switches 
to another user so that no computing time is wasted. 
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INPUT/OUTPUT FUNCTIONS 

The l/O service routines relieve the programmer of the burden of writing a unique program for each different 
I/O device. One set of input/output commands controls any device; to change devices, the program need 
change only the device name in the initialize command (see INIT, Chapter 4) . The l/O service routines 
perform the more common format translations. 

The I/O service routines take full advantage of the program interrupt system of the PDP-6 to a Nov/ over- 
lapped computation v/ith input/output. The hardware features of the PDP-6 permit devices with relatively 
high data rates (high density magnetic tape, for example) to be operated without a separate data channel 
and without taking up a large percentage of the memory cycles. 

The I/O service routines are organized for ease in adding a service routine for a new or unique device. In 
addition to the new service routine for controlling the new device, only one of the monitor subprograms, 
a routine cqlled lOINIT, need be modified to inform the system about the new device. Thus, the monitor 
for a particular installation consists of a number of executive routines that are the same for all installations; 
a selected set of standard library I/O subroutines to control only those devices actually present at the in- 
stallation; and one subroutine, unique to the particular installation, that informs the system of which de- 
vices are present. 

USER'S CORE STORAGE 

Figure 2-2 is a simplified diagram of the job storage area showing the normal usage of a user's core memory 
allotment. The user requests as much core memory space as he requires. Any number of contiguous IK 
(1024-word) blocks may be assigned to the user. The first 140 (octal) locations are the job data area and 
are reserved by the exec for use when providing service for the user. Some system information and tempo- 
rary storage for accumulators are found in this area. To protect the system information, the exec keeps a 
private copy while allowing the user's program to run and restores the job data area upon stopping the user's 
program . 

The user's program, data, debugging programs, arrays, etc., are loaded in the user's area starting at loca- 
tion 140. Although the actual location may be anywhere in memory, the program is stored in core as if 
the first address actually were 140; reference to the proper addresses is made through the hardware reloca- 
tion system. The memory protection system prevents a user's program from referencing any address outside 
its own job area and thus presents disturbing another user's program. In addition, hardware prohibits a 
user's program from trying to halt the processor or influence the I/O or priority interrupt system. 
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Figure 2-2 Simplified User's Core Storage Map 

When a user's program performs input/output, data is transmitted directly to or from buffers in the job's 
own area. Buffers are created dynamically as required. Space for buffers is taken from the unused memory 
at the end of the user's program; the address of the first unused location is kept in the job data area. 

During program loading, the loader builds a symbol table for linking global symbols and for reference by 
DDT. If DDT is not being used, the symbol table is just additional unused space at run time. If, however, 
DDT is being used, the user must write his program (or assign enough extra core space) so that the I/O 
buffers do not build on top of the symbol table. 

USER AND SYSTEM FILES 

A user's active files are stored on his own reel of DECtape, However, information may originate from, or 
be sent to, any other device when desired. To call for a file, the user (or the user's program) must specify 
a device name, a file name with an optional second name called the extension, and (where ambiguous) a 
data mode. The device name is a 1- to 6-character mnemonic such as PTP for paper tape punch or DTA5 
for DECtape transport number 5. Table 4-1 gives a complete list of device names. The file name is any 
1- to 6-character name (consisting of letters and numbers) selected by the user at the time the file was 
written. The name extension is an additional 1- to 3-character mnemonic describing the information con- 
tained in the file; for example, REL for a relocatable binary file, MAC for a Macro language source file, 
LST for an assembly listing file. Typical data modes are ASCII (A) for ASCII data consisting of 7-bit 
characters packed five to a word, binary (B), dump (D) for core images, and image (!) for unprocessed data 
received directly from a device. 

System files consisting of copies of each of the active CUSP and library programs are kept on one DECtape 
reel mounted on device SYS (usually DECtape transport 0). The files on this tape are accessible by all 
users. A listing of the file names of a standard system-files tape (called the CUSP tape) and directions 
on how to use each of these files appear in Chapter 6. 
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CHAPTER 3 



TIME-SHARING CONSOLE OPERATION 



The user has complete access to all system functions and programs by typing on his time-sharing console. 
User requests are processed in one of two distinctly different ways. Certain requests, such as starting or 
stopping a program or assigning I/O devices, are performed by the time-sharing monitor itself. Other 
functions, such as listing a DECtape file, assembling or compiling source language programs, or loading 
relocatable binary programs, are performed by library programs that are loaded and run in exactly the 
same manner as any user's program. These library programs are called CUSPs (Common User S^ervice P^ro- 
grams). This chapter explains how to give the commands accepted by the time-sharing monitor; succeed- 
ing chapters explain how to give commands to the various programs in the standard CUSP library. 

CONSOLE STATES 

From the user's point of view, his time-sharing console is in one of three modes (Figure 3-1): the monitor 
mode, the user mode, or the detached mode. In the monitor mode, characters typed in are presented to 
the monitor command processor to be interpreted as a monitor command. In the user mode, characters 
typed in are processed or ignored at the option of the user program. In the user mode the time-sharing 
console acts as an ordinary input/output device. A time-sharing console is in a third state (the detached 
state) if nothing has been typed on it since the monitor was started or if the KJOB (kill job) or DETACH 
command is typed. The console is automatically placed in the monitor mode as soon as any proper moni- 
tor command is typed, in which case, the monitor types back: 

JOB N INITIALIZED 
where N is a number assigned by the monitor for the purpose of Identifying this job. 
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Figure 3-1 Console State Diagram 
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There are three ways to place the console into the user mode and three ways to return the console to the 
monitor mode. Typing one of the three monitor commands— START, CONT, and DDT (explained below), 
places the console in the user mode. Holding down the control key and typing C places the console in 
the monitor mode and stops the user program if it is running. The other two methods of returning to moni- 
tor mode are under program control . The user's program may give the EXIT program command which causes 
the word EXIT to print on the time-sharing console, the program execution to stop, and the console to 
enter monitor mode. If the user's program (or the monitor while servicing the user's program) commits a 
blunder, such as an attempted memory reference outside the user's alloted memory area, the monitor types: 

ERROR IN JOB N 
where N is the job number assigned by the monitor to the user's program, followed by a 1-line description 
of the error. After the error printout, the user's program is stopped and the console is placed in monitor 
mode. 

Upon completion of most commands, the monitor types an acknowledgement (usually a carriage-return/ 
line feed) and waits for further commands. If the user types 'control' C before the acknowledgement is 
typed, the monitor command in progress is stopped before completion. 

CONSOLE COMMAND FORMAT 

All console commands have the same general format. Command names are strings of from one to six letters 
and numbers. Characters after the sixth are ignored. Arguments, when required, follow the command 
name on the same line. Space, and any printing character that is not a letter or numeral, is considered 
a separator and may be used to separate a command name from its argument(s). Spaces and nonprinting 
characters preceding the command name are ignored. A semicolon preceding a line causes the line to be 
disregarded. Other separator characters preceding the line cause the line to be treated as an error. A 
command line is terminated by carriage -re turn/ line -feed, vertical tab, form-feed, or alt mode. Addi- 
tional character processing occurs which is the same as for the Teletype ASCII mode described on page 4-18. 

If the monitor does not understand the typed-in command, it types back the command up to the place it 
could not interpret and appends a question mark followed by the words "MONITOR COMMAND ERROR." 
If the command name is recognized, but a necessary argument for the command is missing, the monitor 
types back: 

TOO FEW ARGUMENTS 
If the user types in more arguments than necessary, the extra arguments are ignored. 

When a command is typed in correctly, the monitor processes the command without further acknowledg- 
ment until either processing is complete, an error occurs in processing the command, or 'control' C is 
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typed. Most commands are processed instantly. The completion of any command causes an extra carriage- 
return/line-feed or a line of printing followed by carrlage-return/line-feed to be typed out. 

In periods of heavy use of the time-sharing system, the job capacity of the monitor may be exceeded. 
The job capacity is limited by table space within the monitor to a number of jobs equal to the number of 
time-sharing consoles physically connected to the system. If any console initiates more than one job, it 
is possible to exceed the job capacity of the system. When the job capacity is exceeded, any command 
typed in to initialize a new job (implicitly as well as explicitly) causes the monitor to respond with: 

JOB CAPACITY EXCEEDED 
If this message occurs, the command is not executed and the user must wait until some other user relinquishes 
his job number (see the explanation of the KJOB command on page 3-9). 

When a user detaches his console from his job, a logical console is left attached to the job while the 
physical console is allowed to attach itself to some other logical console. Therefore, when the number 
of active jobs is equal to the console-handling capacity of the system, the monitor is unable to find a 
logical console to which to attach the next physical console that types in. If all logical consoles are in 
use, a physical console that is not already attached to a logical console cannot communicate with the 
monitor. To inform the user that the console capacity of the system is exceeded, the monitor types the 
letter X each time the user types any character other than X. To make this problem as infrequent as 
possible, the monitor console capacity is one more than the job. capacity. Thus, when the job capacity 
is used up, the next user to type receives the "JOB CAPACITY EXCEEDED" message via the one remaining 
logical console; but, if yet another user starts typing, he receives the "X" indication. However, if a con- 
sole receives the "JOB CAPACITY EXCEEDED" message, the monitor breaks the connection to the logical 
console automatically at the end of the message, thus freeign the logical console for the use of anyone 
who might be receiving the "X" message. 

NOTE: When the "JOB CAPACITY EXCEEDED" message is received, the only 
console command that has a useful effect is ATTACH (see the explanation of 
ATTACH on page 3-10). 

Console Commands for Initializing a Job 
The following commands are most often typed by the user when he first sits down at the console. 

IJOB Initialize JOB. (Required only if someone else has been using the same console.) This 

command initializes the job to the following state: no core assigned; no devices except the 
Teletype assigned; the Teletype given the logical name TTY, The monitor responds with: 

JOB N INITIALIZED 
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PJOB Print JOB number. The monitor types out the number assigned to the job to which the console 

is currently attached. 

ASSIGN ASSIGN I/O devices to this job. This command requires one or two arguments. In the form: 

ASSIGN DEV 
the physical device DEV is reserved for the exclusive use of this job. (See Table 4-1 for a 
complete list of devices and their physical names.) 

in the form: 

ASSIGN DEV NAME 
device DEV is reserved, and in addition, NAME (called the logical name) is made synonymous 
with DEV. If NAME happens to be the same as the physical name of some other device, the 
logical name takes precedence. vVith the ability to rename devices, a user may write his 
programs to use arbitrarily named devices which he assigns to the most convenient physical 
devices at run time. 

For multiple devices such as DEGtape or magnetic tape, the physical name consists of a 3- 

letter device-type mnemonic followed by the unit (transport) number. For example, DTA3 

means DECtape (DTA) transport number 3. To locate a free transport, use only the first three 

characters of the physical device name in place of DEV. For example: 

User types: ASSIGN DTA 

Monitor responds: DEVICE DTA4 ASSIGNED 

Then user types: ASSIGN DTA 

Monitor responds: DEVICE DTA5 ASSIGNED 

In the example above, the monitor is asked to find two free DECtape transports. Transports 
4 and 5 were free and are now accessible only to the user typing the ASSIGN command. 

The monitor may type back one of the three following error messages: 

LOGICAL NAME ALREADY IN USE, The logical name specified is the same as a 
DEVICE X ASSIGNED logical given in a previous ASSIGN com- 

mand. Nevertheless, the device is reserved 
but without a logical name specified. 

ALREADY ASSIGNED TO JOB N Another user is using the device. 

NO SUCH DEVICE Either the physical device name is misspelled 

or (in the case of searching for a multiple de- 
vice) all transports are in use. 
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Examples 

User types: ASSIGN DTA, ABC 

Monitor responds: DEVICE DTA6 ASSIGNED (successful) 

User then types: ASSIGN DTA, DEF (find another transport) 

Monitor responds: NO SUCH DEVICE (all in use) 

User then types: ASSIGN PTP, ABC (reserve the paper tape punch) 

Monitor responds: LOGICAL NAME ALREADY IN (punch is reserved but ABC still 

USE refers to DTA6) 

DEVICE PTP ASSIGNED 
User then types: ASSIGN DTAl, DEF 

Monitor responds: ALREADY ASSIGNED TO JOB2 (another user has reserved DTAl) 

See the DEASSIGN console command for relinquishing devices. 

Console Commands for Starting a Job 
The following three commands must always be typed in order to start a CUSP or user's program. The in- 
itialization commands discussed previously need not necessarily be used; but IJOB is desirable to cancel 
whatever the previous user at the same console hod done. 

CORE Assign CORE memory space. The CORE command requires one argument, a decimal integer, 

specifying the total number of 1024-word blocks of core memory needed to run his program. 
The core assigned becomes inaccessible to all other users. 

If the core assignment is successful, the monitor makes no comment. If there is not a free 
block of core of the size requested, the monitor responds with: 

N FREE IK BLOCKS LEFT, NONE ASSIGNED 
where N is the number of available 1 K blocks of core. When this message occurs, the user 
is left with no core assigned even though he may have had core assigned when he typed the 
command , 

Sometimes the monitor cannot satisfy a core request even though enough core is available to 
do so. This problem is best illustrated by an example. Suppose that at the start of the day, 
two users of a 32K PDP-6 system request 9K of core apiece. With a 6K monitor, only 8K of 
core remains. Then suppose that the user who was assigned the first 9K block relinquishes 
his core. The memory available for the user's programs then consists of a free 9K block, 
an in-use 9K block (by the second user), and a free 8K block. A request for lOK of core 
cannot now be satisfied because the monitor cannot move programs to join two smaller free 
blocks. It is up to each computer installation to develop ground rules for the use of core. 
In this particular instance, the remaining user must save his program, request 9K of core 
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(using a "CORE 9" console command), and restore his program. The monitor assigns the 
lowest 9K block available, thus making the 17K of unused core into one long block. 

To increase his core allotment, the user must retype the CORE command giving the total 
amount of core required. Similarly, to decrease the amount of core (or to relinquish all 
core) the CORE command must be retyped. When changing the amount of core assigned, 
the new core area is always the lowest block of core available that is large enough to fill 
the request. Thus, the user does not necessarily get back any of the same core with which 
he started. 

if a user interrupts his program (by typing 'control' C) while I/O operations are in progress 
and types: 

CORE 
all files are closed, end-of-file is written on output magnetic tapes, and all devices not re- 
served by the ASSIGN console command are returned to the common pool. If instead, the 
user types: 

CORE N 
where N is not zero, all devices in current use may be permanently and irretrievably lost to 
the system. The only recourse is to use one of the error restart sequences described in 
Appendix 4. A second use of the CORE command which may cause the monitor to fail is 
typing: 

CORE N 
while the user program is actually running. (This is possible through the use of STARTC or 
CONTC described below.) 

GET Load the user's core area with a core image that was previously dumped. This console com- 

mand accepts two arguments; a device name and a file name. The device and file names 
specify where to find a previously saved program. (A file name extension of "DMP" is as- 
sumed.) This command is used both for loading CUSP programs from the system library and 
for retrieving previously saved user programs. 

Upon completion of loading a program (usually after a moderate delay), the monitor types: 

JOB SETUP 

The job is fully loaded but not started. Other messages indicate error conditions. These are: 

NO CORE ASSIGNED The user has blocks of core 

N IK BLOCKS OF CORE NEEDED The user has not assigned enough core to load 

his program. He must now type CORE N and 
retype the GET command. 
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FILE NOT FOUND 

DEVICE NOT AVAILABLE 
TRANSMISSION ERROR 



The file name typed is not found in the directory 
for the specified device. 

Another user has control of the specified device, 

A parity or other error condition occurred during 
data transmission. 



START START the user's program running. This command starts execution of the user's program at a 

location specified in the job data area. The console is taken out of the monitor mode and 
placed in the user mode so that succeeding input is directed to the user's program. No check 
is made to see if a program is actually loaded. START accepts an optional argument, an 
octal number which, if specified, is taken as the starting address instead of the address 
found in the job data area. The only error condition is: 

NO CORE ASSIGNED 

Console Commands for Bookkeeping and Debugging 

The following commands are most often used during the running of the user's program for debugging or book- 
keeping purposes. 

SAVE SAVE the user's program on a dump file for later restoration using the GET command. 

If DDT is loaded, the entire user's core area starting at location 75 (JOBCDP) is dumped, 
including DDT's symbol table. If DDT is not loaded, only the core up to the contents of 
JOBFF is dumped. 

The SAVE console command requires the same two arguments as the GET console command. 
The user's program, the starting addresses of the user's program and DDT, and other critical 
parameters are saved in a dump file on the specified device. The file name is the one spec- 
ified by the typist, and the file name extension is always "DMP." During operation of the 
SAVE command, all I/O devices are released and the state of the accumulators and program 
counter is lost. Therefore, after performing a SAVE operation, the user must restart his 
program from the beginning. 

If the SAVE command is successful, the monitor types out (after a moderate delay): 

JOB SAVED 

Other messages indicate error conditions. These are: 

NO CORE ASSIGNED There is no core. 
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N 1 K BLOCKS OF CORE NEEDED 

DEVICE NOT AVAILABLE 
DIRECTORY FULL 

TRANSMISSION ERROR 



The user has assigned less core than is fo be 
dumped according to the contents of JOBFF. 

Some other user is using the specified device. 

No room is left in the directory to enter the 
new file name. 

Some error condition, such as a bad spot on the 
tape, occurred during data transmission. 



DDT 



Start the user's debugging program, DDT . The starting address of DDT, the user's debugging 
program, is a parameter kept in the job data area. When the DDT console command is typed, 
the monitor starts the user's program at the starting address of DDT. The console is taken 
out of the monitor mode and placed in the user mode so that input Is directed to DDT. 



Error messages are: 

NO CORE ASSIGNED 
NO DDT 



The user has no blocks of core. 

The starting address of DDT, as stored in the 
job data area, is 0; therefore DDT is not 
loaded. 



CONT CONTinue execution. When a user's program (including DDT) is stopped by typing 'control' 

C (C while holding down the 'control' key), execution is resumed by typing the CONT con- 
sole command. If the user's program stops running because of an error condition or if the 
user's program deliberately stops by calling "EXIT," the CONT command does not restart 
the |ob. 



Error messages are: 

NO CORE ASSIGNED 
CAN'T CONTINUE 



Either the program was never started or it was 
stopped by other than 'control' C. 



Console Commands for Terminating a Job 

The following commands are most often used at the end of a computer run when the user is about to leave 
his console. These commands are also used as a convenient means for relinquishing facilities during a 
session on the computer. 



NOTE: Never abandon a time-sharing console with facilities attached. By 
so doing, those facilities are lost to other users for the remainder of the day. 
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DEASSIGN Return I/O devices to the common pool. This command cancels device reservations mode 

via the ASSIGN command. The DEASSIGN command may be typed alone or with one argu- 
ment. When an argument is typed, it must be the logical or physical name of some device 
that v^as previously reserved by the ASSIGN command. If no arguments are typed, all de- 
vices currently reserved by user via ASSIGN commands are affected. The DEASSIGN com- 
mand may be typed even though the user's program continues to use the devices affected. 



Error messages are: 

NO SUCH DEVICE 

DEVICE WASN'T ASSIGNED 



The specified device does not exist. 

The specified device was not reserved by the 
ASSIGN command. 



KJOB Kill the JOB. This console command does the following: 

1. Deassigns and stops all I/O devices connected to the job. 

2. Returns all the user's core allotment to the monitor. 

3. Places the console in the detached state. 

4. Makes the job number assigned to the killed job available to the next user who 
initializes a job. 

Console Commands for Starting More Than One Job 

The following commands are useful for starting and monitoring more than one job from one console. These 
commands may also be used for starting a job and relinquishing the time-sharing console to another user. 

STARTC START the user's program as in the START command, but leave the console in the monitor 

Command mode. The STARTC command differs from the START command in only one respect. 
STARTC leaves the console in the monitor mode so that further monitor commands may be 
typed while the user's program runs. 

Error messages are the same as for START . 

CONTC CONTinue running the user's program with the console in the monitor Command mode. CONTC 

bears the same relation to CONT that STARTC bears to START. The CONTC command is often 
used following a sequence such as: a START command; a control statement typed to the user's 
program in order to initialize the computation; 'control' C. CONTC allows the computation 
to continue while the user types additional console commands to start other jobs such as I/O 
conversions or edits. 

Error messages are the same as for CONT. 
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DETACH Place the console in the DETACH ed mode. The DETACH command disconnects the user's 

console from the job, placing the console in the detached mode but not affecting the status 
of the original job. In the detached state, the user may initialize another job by typing 
IJOB, PJOB, CORE, or ASSIGN. In combination with the STARTC or CONIC command, 
the user can initiate two or more jobs. 

There are no error conditions or acknowledgements. However, when the user tries to initialize 
a new job following a DETACH console command, he may discover that the job capacity of 
the monitor is exceeded. The introduction to this chapter explains the job exceeded condi- 
tion. See the explanation of ATTACH below for corrective action, 

ATTACH Reconnect the console to a previously initiated but now detached job. The ATTACH command 

allows a user to reconnect to a job from which he Vias detached. The ATTACH command re- 
quires one argument which must be the job number of the job to which the user desires to 
connect. There is no acknowledgement if the ATTACH operation is successful. Following 
the ATTACH, the console is always in the monitor mode. If the job happens to be running, 
typing "CONT" places the console in the user mode without affecting the operation of the 
job. A user may type ATTACH on any console, not necessarily the one from which he de- 
tached. It is not necessary to type DETACH before typing ATTACH in order to switch the 
console between two or more previously initialized jobs. 

If an error condition occurs, the console is left attached to the job to which it was connected 
before the ATTACH was typed. The error messages are: 



TTYn ALREADY ATTACHED 



JOB NEVER WAS INITIATED 



ILLEGAL JOB NUMBER 



Either the job number typed is erroneous and by 
coincidence is in active use at some other con- 
sole, or another user has attached to the job 
number specified. 

The job number typed belongs to an inactive job, 
possibly because a user has attached to the job 
and typed "KJOB," 

The job number typed is not the number of a 
legitimate job, including and numbers which 
are in excess of the job capacity of the monitor. 



NOTE: Do not ATTACH to any job without the consent of user who origin- 
ated that job. 
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CHAPTER 4 
PROGRAMMING FOR USERS' PROGRAMS 



The user's program area is the portion of core memory available to the user when his program is running. 
The first address of this area is defined by the contents of the memory relocation register when the user's 
program runs, and the last address is defined by the contents of the memory protection register. The user's 
area is shown in Figure 2-1 . 

In order to make the following discussion clearer, it is necessary to define some terms and review briefly 
the operation of the PDP-6 time-sharing hardware. The user's program runs while the computer is in a 
special mode called user mode. In this mode, the contents of the memory relocation register in the arith- 
metic processor are added to each memory address before the address is sent to the memory system. The 
address before this addition takes place is called the relative address; after the addition the address is called 
the absolute address. In the following discussion, all addresses in the user's area are relative addresses. 

To take advantage of the fast accumulators, accumulator addresses (0 through 17) are not relocated. Thus, 
relative locations through 17 cannot be referenced by the user's program. The Time-Sharing Monitor 
saves the user's accumulators in this area while the system is servicing a programmed operator request. The 
contents of the memory protection register are compared with the eight high-order bits of each relative ad- 
dress as the user's program runs. If the relative address exceeds the contents of the memory protection reg- 
ister, the memory violation flag Is set and control traps to the Time-Sharing Monitor, Some instructions 
trap to absolute location 40 when executed in the user mode. These instructions include JRST instructions 
which attempt to halt and all undefined operation codes. The action on traps to location 40 is the same 
as the action for programmed operators in executive mode, with the addition that the user mode is turned 
off when the trap occurs. Input/output interrupts also turn off the user mode and trap to the absolute loca- 
tions normally used in executive mode. All numbers in the following discussion are octal unless otherwise 
indicated. 

SYSTEM PARAMETERS IN JOB AREA 

The first 140 registers of the user job area comprise the job data area which is reserved for storing specific 
information concerning the job, such as the starting address of the user's program and the I/O device as- 
signments made for this program. Also in this area are registers for saving accumulators during requests 
for service to the executive system or while some other user's program is running. An understanding of 
the functions of the specifically reserved locations Is required for efficient use of the services of the 
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Time-Sharing Monitor. The monitor makes its own copy of critical registers in the job data while the job 
is running and restores these locations to the original values whenever the user's program becomes inactive 
(due to waiting for I/O or running another user's program). These registers are labeled "protected" in the 
description below. Some of the protected locations can be modified through the use of the CALL UUO 
described later in this chapter. The mnemonic assignments given below are made on the library file, 
JOBDAT, as internal symbol definitions. User's programs must be written with job data area mnemonics 
declared as externals and loaded with file JOBDAT. A listing of JOBDAT and the definitions of system 
UUO's (unused operation codes) appears in the appendix. 

SYSTEM PUSHDOWN LIST 

In addition to specific-purpose locations described below, the Time-Sharing Monitor maintains a pushdown 
list in the user's area for general purpose temporary storage. All the temporary storage required for serving 
each user is contained within the user's area and thus, the Time-Sharing Monitor can switch to serving an- 
other user at any time without forgetting what it was doing for the original user. 



JOBAC 



JOBDAC 



JOBUUO, JOB41 



The block of core memory from user's location through 17 cannot be referenced 
by the user's program because the arithmetic processor substitutes absolute registers 
through 17. The block of 20 registers starting at JOBAC, defined as user's 0, 
stores the user's accumulators while servicing Executive requests via the programmed 
operators. 

A second block of 20 registers stores the accumulators while a job is inactive. 
Since a job may become inactive either while the user's program is computing or 
while the Executive program is processing a user's request, the information saved 
may belong to either the user's program or the Executive program. 

Two registers at user's 40 and 41 are used for processing user's programmed operators 
(001 through 037). The Time-Sharing Monitor reserves programmed operators 040 
through 077 for various purposes. The remaining programmed operators (except 000 
which is considered illegal) are executed as described in the PDP-6 Programming 
Handbook using user's locations 40 and 41 instead of absolute 40 and 41 . JOBUUO 
is user's location 40 and JOB41 is location 41 . 



JOBPC 



The location JOBPC saves the program counter and arithmetic processor flags while 
the job is inactive. 
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JOBPDP 



JOBREL 



JOBUXT 



JOBLEV 



JOBSAV 



JOBPOV 



JOBJDA 



JOBDDT 



JOBSYM 



Protected. The Executive program maintains a pushdown list in the last 16 locations 
of the user's job data area. JOBPDP contains the pushdown pointer to this pushdown 
list. 

Protected. The left half of JOBREL is zero. The right half contains the highest 
relative location available to the user, in particular, the contents of the memory 
protection register. 

Protected. JOBUXT contains the program counter and processor flags for returning 
to the user's program after the Executive is called by a programmed operator. 

Protected. JOBLEV contains the contents of absolute location 40 when the job is 
inactive. 

Protected. JOBSAV is a general purpose temporary register for use by the pro- 
grammed operator processor. 

Protected. JOBPOV contains an address In the user's program to which to jump if 
a pushdown list overflow trap occurs. If JOBPOV contains 0, no jump occurs, but 
the monitor stops the user's program and prints an error message on the user's 
console. 

Protected. A block of 20 registers starting at JOBJDA contains the correlation be- 
tween input/output devices and the device channel assignments requested by the 
user's program by means of the INIT prog. op. 

Protected. JOBDDT contains the starting address of DDT, the user's debugging 
program. When the user types DDT on his console, the monitor finds the starting 
address of DDT in this location. If JOBDDT contains zero. It is assumed that DDT 
is not loaded. 

JOBSYM contains a pointer to the symbol table created by the Linking Loader. 
DDT uses this symbol table for printing and interpreting symbolic addresses. The 
left half of JOBSYM contains a negative count of the length of the symbol table 
and the right half contains the lowest register used. 
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JOBSA JOBSA contains two addresses. The left half contains the highest register used by 

the program plus one. The user's input/output buffers are placed in the area im- 
mediately following this highest register. The right half contains the starting ad- 
dress of the user's program, initially, this address is set to the starting address 
seen by the Loader. 

JOBFF The right half of JOBFF contains the address of the first free location following the 

user's program. This register is updated by the input/output service routines when- 
ever an input/output buffer is created. The user's program should restore the con- 
tents of JOBFF after finishing all use of a buffer in order to recover the core mem- 
ory used. The left half of JOBFF is not used and normally contains zero. 

The remaining locations in the job data area are reserved for future expansion and development. Proposed 
usage for some of these locations are: 



JOBTEM 



JOBINF 



JOBCDP 



JOBTRP 



Two locations beginning with JOBTEM to be reserved for general purpose temporary 
system storage . 

The location JOBINF would contain the job number assigned to the user in bits 
through 1 1 • 

JOBCDP would contain a byte pointer that points to a command string. The Time- 
Sharing Executive would accept a command typed on the user's Teletype and de- 
termine which system program must be called to process the command. The Executive 
would then load the system program and set up JOBCDP to point to the command 
string. The system program then examines the command string, one character at a 
time, and performs the command operation. 

A block of 20 locations beginning with JOBTRP will contain instructions to be ex- 
ecuted when an input/output error or unusual condition occurs. One location is 
associated with each device channel. If the trap location contains 0, the program 
is dismissed if an attempt is made to trap on that channel . Otherwise, a JSR in- 
struction is presumed to be in the trap location and control is transferred to the spec- 
ified trap subroutine as if by a JSR regardless of what instruction is actually at the 
trap location. 
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JOBUSY JOBUSY will contain a pointer to a list of symbols that are defined at the end of 

the loading process. The user will be able to define all such symbols by means of 
DDT. DDT will automatically adjust each location where the newly defined sym- 
bols are called for. 

In addition to the named locations above, all locations between JOBFF and 137 inclusive are reserved for 
the system pushdown list. The system program loader always starts loading at user's location 140. 

USER INPUT/OUTPUT INSTRUCTIONS 

The input/output service routines provide the input/output facilities for programs running under the PDP-6 
Time-Sharing Monitor System . The object of these routines is to simplify coding for the various input/ 
output devices as much as possible and yet to provide flexibility for performing the most sophisticated 
functions of input/output. Full advantage is taken of the program interrupt facility of the PDP-6 to over- 
lap in/out operations with computation. 

The user's program communicates with the I/O service routines by means of the programmed operators. 
The terms programmed operator (prog, op.) and unused operation code (UUO) are synonymous. Typical 
prog. op. functions are to set up a buffer area, to transmit a buffer full of data to an output device, or 
to release a device for use by other users. 

Ring Buffers 

Core memory serves as an intermediate buffer between the user's program and the in/out device. An I/O 
buffer consists of a header block (three words for bookkeeping) and a data storage area. The storage area 
is subdivided into one or more individual buffers arranged in a ring. To be specific, assume that the de- 
vice is an input device. Once input operations are under way, the I/O service routines fill a buffer, make 
the buffer available to the user's program, advance to the next buffer, and begin to fill it if it is free. 
After filling the last buffer in the storage area, the next buffer to be filled is the first buffer in the area; 
hence the name ring buffer. 

The user's program follows along behind, emptying the next buffer If it is full, or waiting for the next buf- 
fer to fill up if it is not yet full. 

For output, the user's program and the I/O routines exchange roles, the user filling the buffers and the 
I/O routines emptying them. 
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Buffer Structure 

The buffer structure consists of two separate segments, the header and the storage area. The header consists 
of the following three words. 

Word 1 The right half contains the address of the second word of the buffer 

currently in use by the user's program. Bit 0=1 means no input or 
output has occurred for this ring. 

Word 2 A byte pointer to the last item referenced in the buffer. 

Word 3 A count of the number of bytes remaining in the buffer. 

For most applications, the user's program finds all the information it requires about the state of the buffer 
area in the header. When referring to a buffer by name, the address of the buffer header, not the storage 
area, is implied. 

The storage area is subdivided into a number of individual, equal-length buffers. The size of each buffer 
depends on the requirements of the device serviced by the buffer. The first two words of each buffer are 
reserved for special functions; the first two words are: 

Word 1 Unused, but reserved for a block number from fixed address devices such 

as DECtape or drum. 

Word 2 In the right half, the address of the second word of the next buffer in 

the ring. In the left half, bit is a flag as explained below; bits 1 
through 17 contain the buffer size in words (excluding these two words 
of overhead) . 

Bit of the second word of the buffer, called the use bit, is a flag that indicates whether the buffer con- 
tains active data. This bit is set to 1 by the I/O routines when the buffer is full on input (or being emp- 
tied on output) and set to when the buffer is empty on output (or being filled on input). The use bit 
prevents the l/O routines and the user's program from interfering with each other by attempting to use the 
same buffer simultaneously. 

In all data processing modes, the first data word of the buffer is reserved for a count of the number of data 
words in the buffer (excluding itself). Thus, a buffer may be only partially filled. The left half of this 
word is reserved for other bookkeeping purposes depending on the particular device. 

Job Initialization 

To clear all previous device assignments and prepare the I/O service routines for receiving further initial- 
ization commands, execute the instruction: 
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CALL [SIXBIT /RESET/) 

This must be the first instruction In each program. RESET instantly stops any I/O operations that the job 
has started and, thus, is the only method for releasing a device without waiting for I/O completion. This 
function is necessary when, for example, the line printer is out of paper and cannot finish printing. RE- 
SET also reclaims the buffer area by setting the contents of JOBFF to the address contained in the left half 
of JOBSA. 

Device Initialization 

INITProg.Op. 

A device is initialized and buffer headers specified by executing the command: 

INITD, MODE 
SIXBIT /device name/ 
XWD OBUF,IBUF 
error return 
normal return 

INIT performs the following functions: 

1 . The 4-bit channel number D is assigned to the device name appearing in the SIXBIT 
statement. Henceforth, the I/O service routines Interpret the number D as referring to 
that device. The device name is either a logical or physical name with logical names 
taking precedence (see "ASSIGN" console command) . 

2. The data processing mode is selected by mode (see below). 

3. The buffer area headers are specified to the device service routines. Each header 
must be three locations reserved by the user in his program. Only those headers which 
are to be used need be specified; the output header need not be specified if the program 
performs only input from a device. 

4. The buffer header block is initialized as follows: The first and third words are set 
to zero. The left half of the second word is set up with an appropriate byte-pointer 
size field. 

INIT Data Modes 

One item of information specified in the INIT command is the data processing mode. The following modes 
are available: 
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Octal Code Mnemonic Meaning 

A ASCII, 7-bii- characters, packed left justified by the PDP-6 

byte instructions. 

1 AL ASCII line, same as A except that the buffer is terminated 

by a form-feed, vertical tab, line-feed or ALT mode. 

10 I image, a device dependent mode, the buffer is filled with 

unprocessed data exactly as supplied by the device. 

13 IB Image binary, 36-bit words. This mode is similar to binary 

mode except that no automatic formatting or checksumming 
is done by the service routines. 

14 B Binary, a blocked format consisting of a word count (the 

first word of the buffer) followed by N 36-bit data words. 
Checksumming is done automatically by the service rou- 
tines or by the device itself. The word-count N is in the 
right half of first word of each block, and if a checksum 
is computed (cards, paper tape), it is in bits 6-17. This 
12-bit folded checksum is computed by summing the 36-bit 
data words in the block (2's complement add), followed by 
a 1 's complement sum of bits 0-1 1 , 12-23, 24-35. 

16 DR Dump respecting record boundaries. Data is transmitted be- 

tween any contiguous block of core and one record on the 
l/P device. In dump mode, ring buffers are not used. The 
control for the size of the data block and the location in 
core memory is from a command list explained below. 

17 D Dump, same as DR except that record boundaries are ignored 

on input and arranging the data into standard- length re- 
cords is automatic on output. 

If the INIT prog. op. specifies a mode that is not appropriate for the given device, the user's job is 
stopped and the following error message is typed on the user's console: 

ILL DEVICE DATA MODE FOR DEVICE X AT USER LOC N 

where X is the physical name of the device and loc N is the address of the INIT (or SETSTS described 
below) prog. op. 

INIT Control Modes 

In addition to the four bits to specify one of the data modes described above, some of the remaining ad- 
dress bits of the INIT prog. op. specify special control functions. Because most of these bits specify 
device-dependent processing and do not perform the same function for all devices, only the bits that are 
defined for all devices are described below. The other bits are explained in the separate discussions for 
each device. 
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Bit Name Action 

31 lOWC I/O word count. If a 1, forces the service routines to accept 

the word count in the first data word of the buffer (as computed 
by the user) instead of computing a word count from the con- 
tents of the byte pointer in the buffer header (output only). 

30 lOCON I/O discontinuous mode. If a 1 , specifies stopping the device 

after each buffer is filled (input only). 



A device may be initialized separately on two device channels if one INIT prog. op. specifies the output 
buffer header and the other specifies the input buffer header. All further prog. ops. may then refer to 
either channel number; the OUTPUT prog. op. can use the channel that was initialized for input, for 
example. 

If any of the I/O prog. ops. that require a device channel specification are given (except INIT, CLOSE, 
and RELEAS as explained below) before a device is actually initialized on that channel (by the INIT prog, 
op.), the monitor stops the user's program and types the following error message on the user's console: 

I/O TO UNASSIGNED CHANNEL AT USER LOC N 

where N is the address in the user's area of the offending prog. op. 

Buffer Initialization 

INBUFProg. Op. 

To set up a ring buffer for input data, a program executes the prog, op.: 

INBUFD,N 

where N specifies an N-buffer ring and D specifies a device channel number (the INIT prog. op. must be 
used previously). 

The storage space for the buffer ring is taken from the free storage following the program. The location 
JOBFF (a permanent global symbol defined on the system symbol file, JOBDAT) contains the address of 
the first free location following the program. The contents of JOBFF are updated after each INBUF prog, 
op. If the user wishes to abandon a buffer for one device and set up a buffer for another device, the pro- 
gram should restore the contents of JOBFF to the original value. Then the I/O service routines can reuse 
the old buffer area in core memory for setting up the new buffer. The RESET operation explained above 
also resets JOBFF to its initial value calculated when the program is loaded. 
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OUTBUF Prog. Op. 

An ouput buffer area is set up by: 

OUTBUF D,N 

If no buffer area is set up when the first input or output command is issued, a two-buffer ring is set up 
automatically from the free storage following the program. 

File Initialization 
LOOKUP and ENTER Prog. Ops, 

These programmed operators initialize a file of data. An ENTER must be given before output, and LOOK- 
UP before input. These prog. ops. have no effect for single-file devices such as paper tape or Teletype 
input/output. With a multiple-file device, DECtape in particular, these programmed operators specify a 
file name extension for the file. The format for LOOKUP and ENTER is: 

LOOKUP D,E ENTER D,E 

error return error return 

OK return OK return 

D is the device number assigned to the DECtape. E is the first address of a 4-word directory entry block 
that must be reserved by the user. For both LOOKUP and ENTER, the user's program must put the desired 
file name in sixbit code into E, the first word of the directory block. Likewise, the file name extension 
must be put into the left half of the word at E+1 . For ENTER only, the date may be placed in the right- 
most 12 bitsof E+2. 

The monitor action on ENTER is: 

1 . The monitor searches the directory of the specified device for a matching file name 
and file name extension. If no extension is specified (the extension bits are zero), 
the file name extensions are excluded from the directory search. 

2. If a matching entry is found, the new entry replaces the old. Otherwise, the new 
entry is appended to the directory. 

3. File retrieval information is added to the directory entry. The date, if not already 
specified, is inserted in the third word of the directory entry. 

4. The I/O service routines are initialized to begin outputting at the location specified 
by the directory entry. 
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5. If the directory is full and there is no room for appending the new entry, the monitor 
takes the error return. If the entry is successful, the monitor takes the OK return. 

The monitor action on LOOKUP is: 

1 . The monitor searches the directory as for ENTER. 

2. If no matching entry is found, the monitor takes the error return. 

3. The complete four-word directory entry is copied from the device directory into the 
four -word block at E . 

4. The file retrieval information is given to the I/O service so that inputting may begin 
at the beginning of the file. 

5. If the LOOKUP is successful, the monitor takes the OK return. 

Data Transmission 

The two prog, ops., INPUT and OUTPUT, are used to synchronize I/O operations with the user's program. 
The format for INPUT and OUTPUT is: 

INPUT D,0 OUTPUT D,ADR 

D is the device number assigned to the desired device. ADR, optional and usually zero, is explained 

below. 

The functions of these two prog. ops. are similar, one serving for input operations and the other for output 
operations. The commands operate as follows: 

INPUT Prog. Op. (Non-Dump Mode) 

This prog. op. releases the current buffer to the I/O routines for refilling and advances the buffer header 
pointers to the next buffer. If the next buffer is not full when the input prop. op. is given, the I/O 
routines delay until the buffer is full or an end-of-file indication is received. Since the input device 
normally continues until all buffers are full, the input prog. op. serves to synchronize the user and the 
input device. 

OUTPUT Prog. Op. (Non-Dump Mode) 

This prog. op. computes a word count from the position of the byte pointer In the buffer header, stores 
the word count in the right half of the first data word in the buffer, and makes the buffer available to the 
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device for outputting. The buffer header pointers are advanced to the next buffer, and the item count is 
set to the maximum number of bytes that can fit in the buffer. The service routines assure that the new 
buffer is empty by waiting until it is output, if necessary, and then clear the buffer to zero. 

If ADR is nonzero, it is taken as a pointer to the word of the next buffer. The sequence of buffers in the 
ring thus can be altered. The buffer pointed to by ADR can be in an entirely separate ring from the pre- 
vious buffer. Once a new buffer position is established, the following buffers are taken from the ring 
starting at ADR. When using this feature in output operations, the I/O routines compute an improper 
word count unless one of the following precautions is taken: 

1 . In the INIT prog. op. have bit 31 a 1 to prevent the service routines from computing 
a word count (useful if the user's program computes its own word count and places it in 
the right half of the first data word of the buffer or if outputting directly from an input 
buffer) , 

2, Set the byte pointer of the buffer header to point to the last item in the new buffer. 

Examples 

When the INIT command is given, the item count in each buffer header is set to zero and the byte size is 
set according to the data processing mode. The INBUF and OUTBUF commands set the first word of the 
buffer header to point to the first buffer in the ring. The remaining header words are set up when the first 
input or output command is given. If the item count is ignored by the user's program during output opera- 
tions, the output prog. op. must be given once following the INIT prog. op. to set up the output buffer 
header. This one appearance of OUTPUT does not cause data transmission to the device. If the user's 
output subroutine checks the item count before putting data into the output buffer, this initial output 
command happens automatically. 

A typical Get One Character subroutine from an input device is: 

GET: 

SOSGIBUR-2 ;DECREMENT ITEM COUNT AND TEST 

INPUT D, ;IF NO DATA, CALL INPUT 

ILDB AC,IBUF4-1 ;GET NEXT CHARACTER IN AC 

JRST@GET ;EXIT 

A typical Output One Character Subroutine would be: 

PUT: 

SOSG OBUF<-2 ;DECREMENT ITEM COUNT AND TEST 

OUTPUT D, ;IF NO ROOM LEFT CALL OUTPUT 

IDPB AC,OBUF+l ;DEPOSlT CHARACTER FROM AC 



JRST@PUT 
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INPUT and OUTPUT Prog. Ops. (Dump Mode) 

When using dump mode (either 16 or 17, D or DR), the ring buffer scheme is entirely eliminated. Instead, 
input and output are done directly from the user area. Control of I/O operations is via a command list. 
The location of the command list is given by the INPUT or OUTPUT prog. op. in the format: 

INPUT D,ADR OUTPUT D,ADR 

D is the device number assigned to the desired device. 

Command List Format 

The command list format varies for the specific device but is in general: 



lOWD A,B 
XWD 0, A 




TRANSFER A WORDS STARTING AT CORE LOCATION B. 
GO TO A FOR THE NEXT COMMAND 
TERMINATE THE COMMAND LIST 



The command list is assumed to be in sequential locations except v/hen a GOTO word is encountered. The 
input/output service routines delay until the command list is completely processed before returning control 
to the user's program. 

Status Checking and Setting Prog. Ops. 

Certain errors, such as parity or checksum errors, can occur during data processing. For each 4-bit device 
number, a status word is provided which contains error indication bits and other useful conditions. The 
status word is examined or tested by the commands: 

GETSTS D,ADR or STATZ D, MASK or STATO D,MASK 

These three prog. ops. are exactly analogous to the PDP-6 instructions CONI, CONSZ, and CONSO 
except that D is the 4-bit device channel number. 

Status Bits 

The bits of the status word have the following meanings: 

Bit Meaning 

18 lOIMPM, Improper Mode. The selected mode is unobtainable. 

19 lODERR, Device Error. The device's self-checking circuits indicate an error 
(parity failure, etc) . 

20 iODTER, Data Error. The computed checksum failed or invalid data was received. 
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Bit Meaning 

21 lOBKTL, Block Too Large. A block of data from a high-speed device (DEOape, 
mag tape, drum) was too large to fit in one buffer. 

22 lODEND, Data End Encountered. End-of-file. 

23 lOACT, Device Active and Currently Transmitting Data. 



Bits 26 through 35 read back the mode transmitted to the I/O service routines by the most recent INIT or 
SETSTS (see below) prog. op. Bits 24 and 25 give device-dependent conditions that are explained below 
for each particular device. 

At times it is necessary to change certain bits in the status word; for example, clearing error bits or the 
end-of-file bit, or changing data modes during I/O operations. The prog, op.: 

SETSTS D,BITS 

delays until the device on device channel D stops transmitting data, then replaces the status word with 
BITS. All bits of the status word are affected by this prog. op. except bit 23 (lOACT) . If the data mode 
is changed by this prog, op., the byte pointers in the buffer headers are changed appropriately. Note 
that there is only one status word per device even though a device is initialized on more than one device 
channel. 

Terminating a File 

To terminate a file use the CLOSE prog. op. The format is: 

CLOSE D, 

CLOSE finishes output operations on device channel D by dumping the last buffer if it is partially full and 
by writing an end character if the device requires one. For input operations, all buffers are emptied by 
setting the use bits to zero and the item count in the buffer header to zero. For either input or output, 
the device is returned to the same state as before the first input or output command. 

CLOSE does not necessarily terminate the input file and the output file if the device is 2-way. If the 
OUTPUT prog. op. was used on channel D, the output file is terminated when CLOSE is used on channel D. 
Similarly, the input file is terminated only if the INPUT prog. op. was used. Also, the user's program 
may deliberately inhibit the termination of either the input or output file by using CLOSE with the follow- 
ing format: 

CLOSE D,N 
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If N is equal to 1, the output file is not terminated regardless of whether an OUTPUT prog. op. was used. 
If N is equal to 2, the input file is not terminated. If N is equal to 3, neither file is terminated and the 
only action is a delay until the device becomes inactive. 

Relinquishing a Device 

When all I/O to a device is finished, the user's program must give the prog, op.: 

RELEASE D, 

RELEASE performs a CLOSE operation unless CLOSE was used previously. Then the device on channel P 
is made available for other users except when the device is reserved by the ASSIGN console command. 
A new INIT prog. op. must be given if further operations with the device are required. 

If a device is initialized on one channel for input and another for output, only the appropriate channel is 
affected by RELEASE. 

I/O Synchronization 

In some instances it is desirable to delay until a device has completed its input/output activities. For 
example, a program that backspaces magnetic tape might follow up each backspace with a check for the 
load-point status bit. Because the backspace prog. op. returns to the user before the operation is com- 
plete, the user's program must somehow delay in order to check for the load-point status at the end of the 
backspace operation rather than during the middle. The following prog. op. provides the delay function: 

CALLD, [SIXBIT/WAIT/] 

This prog. op. does not return control to the user's program until the device on channel D becomes inactive. 

Device Characteristics Checking 

The following prog. op. allows a user's program to determine a great deal of information about a device 
both before and after initializing the device. The sequence: 

MOVE AC, [SIXBIT/NAME/] 
CALL AC, [SIXBIT/DEVCHR/1 

loads into accumulator AC a word describing the characteristics of the device having the physical or logi- 
cal name NAME. Bits in the device characteristic word are interpreted as follows: 
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Bit Meaning 

22 through 35 Data modes are permitted for this device. Mode J is permitted if bit 35-J 

is a 1 . 

21 If 1, this device is reserved for some job by an INIT prog. op. 

20 If 1 , this device is reserved for some job by the ASSIGN console command. 

17 If 1 , this is an output device. 

16 If 1, this is an input device. 

15 If 1, this device has a directory (DECtape is currently the only such de- 

vice). If 0, the prog. ops. ENTER and LOOKUP act as SKIPA instruc- 
tions. 

14 If 1, this device is a Teletype. 

13 If 1/ ''his device is magnetic tape. If 0, the MTAPE prog. op. acts as a 

no-op. 

12 If 1, the device is accessible to this job by an INIT prog. op.. However, 

the device may become unavailable between the DEVCHR and the INIT 
prog. op. unless bit 21 or 20 is already 1 . 

6 through 1 1 Image mode byte size; if image mode is not permitted. 

5 if 1 , the device is a Teletype that is in use (someone has typed on it) . If 

0, the device either is not a Teletype or is in the detached mode. 

4 If 1 , this device is the user's console Teletype. If 0, this device is not 

the user's console Teletype. This bit is set to when the user types the 
DETACH command. 

3 If 1, this device is the line printer which accepts special carriage con- 

trol characters as described in the PDP-6 Handbook, F-65. 

2 If 1 , this device is a card reader for which each line is filled out to 80 

characters with spaces. 

1 Unused . 

If 1 , the device is a DECtape for which the directory is in core. 

Bits 0, 4, and 5 are intended for the use of the monitor rather than for providing useful indications for 
the user. 

If the user's program requests the characteristic word for a nonexistent device name, the word returned 
is zero. 

DEVICE DEPENDENT FUNCTIONS 

The paragraphs below explain the unique features of each I/O device. All devices accept the prog. ops. 
explained above unless otherwise specified. Buffer sizes below are octal and include the two bookkeeping 
words. Table 4-1 is a summary of the characteristics of all devices. 
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TABLE 4-1 DEVICE SUMMARY 






Physical Name 



Name 



Hardware 
Type Number 



Prog. Op. 



Data Modes 



Buffer 
Size (octal) 



CTY 


Console 
Teletype 


626 


INPUT 
OUTPUT 


A, AL 


23 


TTYl, TTY2, 
. . . , TTY77 


Teletype 


630 


INPUT 
OUTPUT 


A, AL 


23 


PTR 


Paper Tape 
Reader 


760 


INPUT 


A, AL, IB, B, 1 


43 


PTP 


Paper Tape 
Punch 


761 


OUTPUT 


A, AL, IB, B, 1 


43 


LPT 


Line Printer 


646 


OUTPUT 


A, AL 


34 


CDR 


Card Reader 


461 


INPUT 


A, AL, B, I 


36 


DTA1, DTA2, 
... , DTAO, 


DECtape 


55\/555 


INPUT 

OUTPUT 

LOOKUP 

ENTER 

USETO 

USETI 

UGETF 

CALL [SIXBIT/UTPCLR/l 


A, AL, IB, B, 1, 

DR, D 


202 


MTAO, MTAl , 
... , MTA7 


Magnetic 
Tape 


516 


INPUT 

OUTPUT 

MTAPE 


A, AL, IB, B, 1, 
DR, D 


203 



Teletype 

Device Name - TTYO, TTYl, ..., TTY76, TTY77, CTY 

Line number N of the Type 630 Data Communications System is referred to as TTYN, The console Teletype 
is CTY. The Time-Sharing Monitor automatically gives the logical name, TTY, to the user's console when- 
ever a job is initialized. 

Teletype device names are assigned dynamically. An idle line is considered nonexistent. For interconsole 
communication, it is necessary for one of the two users to type "DEASSIGN TTY" in order to make his 
Teletype available to the other user's program as an output or input device. Typing "ASSIGN TTYN" or 
"IJOB" is the only way to reassign a Teletype that has been deassigned. 

Buffer Size - 23 

Data Modes A. ASCII - All characters typed in appear in the input buffer as typed with the following 
exceptions: 



RUBOUT 



RETURN 



'control' U 



erases the previous character. Successive rubouts erase characters to the left 
until the beginning of the current bufferful. For each character erased, a back- 
slash is typed. If there is no character to erase, a carriage-return/line-feed is 
typed . 

is followed automatically with line-feed, both of which appear in the input 
buffer . 

types back astU followed by carriage-return/line-feed. This character deletes 
the entire current bufferful of ASCII characters. 



'control' O 
'control' P 



'control' Z 



similar to 'control' U but has special action during output. 

does not appear in the input buffer. This character informs the I/O service rou- 
tine that there is a Type 35 Teletype on the line. The difference between the 
two Teletype models is that the Type 35 has a tab, form-feed, and vertical tab 
mechanism that the Type 33 does not have. Alternate uses of 'control' P turn the 
special "Type 35" mode on and off, 

types as tZ and appears in the buffer as 032, This character serves as an end- 
of-file. 
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TAB echoes as an appropriate number of spaces to place tab "stops" at every eighth 

space unless 'control' P is typed. 

VT (vertical tab) types as four line-feeds. 

FORM (form-feed) types as eight line-feeds. 

'control' C types asfc followed by carriage-return/line-feed. This character places the 

console in the monitor mode, ready to accept monitor commands. 

On output all characters are typed just as they appear in the output buffer with the exceptions, TAB, VT, 
and FORM, which are processed the same as on typein. 

If, during output operations, an echo-check failure occurs (the transmitted character was not the same as 
the intended character), the i/O routine suspends output until the user types the next character. If that 
character is 'control' C, the console is placed in monitor mode. If it is 'control' O, all Teletype output 
buffers that currently are full are ignored, thus cutting the output short. All other characters cause the 
service routines to continue output. The user may cause a deliberate echo check by typing in while 
typeout is in progress. For example, to return to monitor control mode while typeout is in progress, the 
user must type any character ("X", for example) until an echo check occurs and output is suspended; 
then and only then he types 'control' C. 

AL. ASCII Line - All input character processing is the same as for the ASCII mode. However, the buffer 
is terminated on RETURN (carriage-return), LINE FEED, FORM, VT, "control Z", and ALT (alt mode, 
(175) sometimes labeled ESC, escape). One of these characters always appears at the end of each buffer- 
ful, RETURN is always followed by LINE FEED so that RETURN is never the last character in the buffer. 

On output, AL mode is no different from the A mode. 

DDT Submode 

In order to allow a user's program and the DDT debugging program to both use the console Teletype with- 
out interfering with one another, the Teletype service routine provides the DDT submode. This mode is 
entered by the prog, op.: 

CALL [SIXBIT/DDTGT/] 

and left by the prog, op.: 

CALL [SIXBIT/DDTRL/] 
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and does not affect the Teletype status if it is initialized with the INIT prog. op. It is not necessary to 
use the INIT prog. op. in order to do I/O in the DDT submode. I/O in DDT mode is always to the user's 
console and not to any other device. 

In the DDT submode, the user's program is responsible for its own buffering. Input is usually one character 
at a time, but if the typist types characters faster than they are processed, the Teletype service routine 
supplies a bufferful of characters at a time. 

To input characters in DDT mode, use the sequence: 

MOVEI AC,BUF 

CALL AC, [SIXBIT/DDTIN/] 

BUF is the first address of a 21-word block in the user's area. This prog. op. delays if necessary, until 
one character is typed in. Then all characters (in 7-bit packed format) typed in since the previous occur- 
rence of DDTIN are moved to the user's area in locations BUF, BUF+-1, etc. The character string is always 
terminated by a null character (000) . Rubouts are not processed by the service routine but are passed on 
to the user. The special control characters 'control' O and 'control' U have no effect. Other characters 
are processed as in ASCII mode. 

To perform output in DDT mode, use the sequence: 

MOVEI AC, BUF 

CALL AC, [SIXBIT/DDTOUT/] 

BUF is the first address of a string of packed 7-bit characters terminated by a null (000) character. The 
Teletype service routine delays until the previous DDTOUT operation is complete, then moves the entire 
character string into the monitor, begins to output the string, and restarts the user's program. Character 
processing is the same as for ASCII mode output. 

Paper Tape Reader 

Device Name - PTR 
Buffer Size - 43 

Data Modes (Input Only) 

A. ASCII - Blank tape (000), rubout (377), and null characters (200) are ignored. All other characters 
are truncated to seven bits and appear in the buffer. Turning the reader off serves as an end-of-fiie and 
results in the character 032 ('control' Z) appearing in the buffer. 
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AL. ASCII Line - Character processing is the same as for the A mode. The buffer is terminated by LINE 
FEED, FORM, or VT. 

I . Image - There is no character processing. The buffer is packed with 8-bit characters exactly as read 
from the input tope. Turning the reader off is the end-of-file indication but does not cause a character 
to appear in the buffer. 

IB. Image Binary - Characters not having the eighth hole punched are ignored. Characters are truncated 
to six bits and packed six to the word without further processing. This mode is useful for reading binary 
tapes having arbitrary blocking format. 

B. Binary - Checksummed binary data is read in the following format. The right half of the first word of 
each physical block contains the number of data words that follow and the left contains half a folded 
checksum. The checksum is formed by adding the data words using 2's complement arithmetic, then split- 
ting the sum into three 12-bit bytes and adding these using Ts complement arithmetic to form a 12-bit 
checksum. The data error status flag (lODERR) is raised if the checksum miscompares. Because the check- 
sum and word count appear in the input buffer, the maximum block length is 40. The byte pointer, how- 
ever, is initialized so as not to pick up the word count and checksum word. 

Again, turning the reader off is the end-of-file indication but does not result in putting a character in the 
buffer. 

Paper Tape Punch 
Device Name - PTP 
Buffer Size - 43 

Data Modes 

A. ASCII - The eighth hole is punched for all characters. Tape-feed without the eighth hole (000) is in- 
serted after form-feed. A rubout is inserted after each vertical or horizontal tab. Null characters (000) 
appearing in the buffer are not punched. 

AL. ASCII Line - The same as A mode. Format control must be performed by the user's program. 

I. Image - Eight-bit characters are punched exactly as they appear in the buffer with no additional 
processing. 
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IB. Image Binary - Binary words taken from the output buffer are split into six 6-bit bytes and punched 
with the eighth hole punched in each line. There is no format control or checksumming performed by the 
I/O routine. Data punched in this mode is read back by the paper tape reader in the IB mode. 

B. Binary - Each bufferful of data is punched as one checksummed binary block as described for the paper 
tope reader . 

Special Prog. Op« Service 

The first output prog. op. of a file causes about two fanfolds of blank tape to be punched as leader. Fol- 
lowing a CLOSE prog, op., an additional fanfold of blank tape is punched as trailer. No end-of-file 
character is punched automatically. 

Line Printer 
Device Name - LPT 
Buffer Size - 34 

Data Modes 

A. ASCII - ASCII characters are transmitted to the line printer exactly as they appear in the buffer. See 
the PDP-6 Handbook, F-65, for a list of the vertical spacing characters. 

AL. ASCII Line - This mode is exactly the same as A and is included for programming convenience. All 
format control must be performed by the user's program including placing a RETURN, LINE-FEED at the 
end of each line. 

Special Prog. Op. Service 

The first output prog. op. of a file and the CLOSE prog. op. at the end of a file cause an extra form-feed 
to be printed to keep files separated. 

Card Reader 
Device Name - CDR 
Buffer Size - 36 
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Data Modes 

A. ASCII - All 80 columns of each card are read and translated to 7-bit ASCII code. Blank columns are 
translated to spaces. At the end of each card a carriage-return/line-feed is appended. A card with the 
character 12-11-0-1 punched in column 1 is an end-of-file card. Columns 2 through 80 are ignored, and 
an end-of-file character 032 appears as the last character in the input buffer. The end-of-file button on 
the card reader has the same effect as the end-of-file card. As many complete cards as can fit are placed 
in the input buffer, but cards are not split between two buffers. Using the standard-sized buffer, only one 
card is placed in each buffer. The left arrow character 137 appears in each column containing an invalid 
punch. The appendix contains the translation table for punching the special ASCII characters on cards. 

AL. ASCII Line - Exactly the same as the A mode. 

I . Image - All 12 punches in all 80 columns are packed into the buffer as 12-bit bytes. The first 12-bit byte 
is column one. The last word of the buffer contains columns 79 and 80 as the left and middle bytes respectively. 
The end-of-file card and the end-of-file button are processed the same as in the A mode with the character 
0032 appearing in the buffer as the last character of the file. Cards are not split between two buffers. 

B. Binary - Card column one must contain a 7-9 punch to verify that the card is in binary format. The 
absence of the 7-9 punch results in raising the lOIMPM (improper mode) flag in the card reader status 
word. Card column two must contain a 12-bit checksum as described for the paper tape reader binary for- 
mat. Columns 3 through 80 contain binary data, 3 columns per word for 26 words. Cards are not split be- 
tween two buffers. The end-of-file card and the end-of-file button are processed the same as in the A 
mode with a word containing 003200000000 appearing as the last word in the file. 

DECtape 
Device Name - DTAO, DTAl , ..., DTA7 
Buffer Size - 202 

Data Modes 

A. ASCII - Data is written on DECtape exactly as it appears in the buffer. No processing or checksumming 
of any kind is performed by the service routine. The self-checking of the DECtape system is sufficient as- 
surance that the data is correct. See the description of DECtape format below for further information con- 
cerning blocking of information. 
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AL. ASCII Line - Same as A, 

I . Image - Same as A. Data consists of 36-bit words. 

IB. Image Binary - Some as I. 

B. Binary - Same as I. 

PR . Dump Records - This mode is accepted but actually functions as dump mode 17. 

D . Dump - Data is read into or written from anywhere in the user's core area without regard to the stand- 
ard buffering scheme. Control for read or write operations must be via a command list in core memory. 
The command list format is as described earlier in this chapter under Input/Output Prog. Ops. (Dump 
Mode), except that the GOTO command is not implemented; any positive number appearing in a command 
list terminates the list. Dump data is blocked into standard-length DECtape blocks by the DECtape control 
automatically. Unless the number of data words is an exact multiple of the standard length of a DECtape 
block (200), after each output prog, op., the remainder of the last block written is wasted. The input 
prog. op. must specify the same number of words that the corresponding output prog. op. specified in order 
to skip over the wasted fractions of blocks. 

DECtape Format 

A standard reel of DECtape consists of 1102 (octal) prerecorded blocks each capable of storing 200 36-bit 
words of data. Between blocks are recorded block numbers which label the blocks for addressing purposes. 
These block numbers run from to 1 101 . Block is normally not used during time-sharing and is reserved 
for a bootstrap loader. Block 1 is the directory which contains the names of all files on the tape and the 
block number where each file begins. Blocks 2 through 1101 are usable for data. 

If in the process of DECtape I/O, the I/O service routine is requested to use a block number larger than 
11 01 or smaller than 0, the monitor stops the user's program and types the following error message on the 
user's console: 

ILL DT BLOCK NO., BUFFER AT X DEVICE DTAY 

where X is the address of the ring buffer involved and DTAY is the offending DECtape unit. 
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The directory format is: 
Word 



Left half Last block number in use. 

Right half The word number in the directory block 

where the first directory entry is found 
(normally 5). Thus, words 1 through 4 
are normally unused. 



Each directory entry contains: 

First word The file name in sixblt code. 

Second word Left half The file name extension in sixbit code. 

Right half The first block number of the file. 

Third word Bits 0-23 Unused (zero) . 

Bits 24-35 The date compressed according to the 

formula: 
((year-1964)*12+(month-l))*31+day-l 

Fourth word Unused in nondump files. For dump files 

requiring a single-word command list, 
the command list word may be stored here 
by the user's program. 

Unused words in the directory contain zero. Thus, zero marks the end of the list of directory entries. 
Thirty entries (decimal) fit in one directory. 

When a directory search is begun for either LOOKUP or ENTER, the service routine examines the right 
half of word Oof the directory. If this half word is not in the range from 1 through 174, the monitor stops 
the user's program and types the following error message on the user's console: 

BAD DIRECTORY FOR DEVICE DATAX;EXEC CALLED FROM USER LOC N 



The file format is: 

A file consists of any number of DECtape blocks. A dump file consists of the required number of adjacent 
blocks, but a nondump file may consist of nonadjacent blocks. For nondump files only, each block con- 
tains: 



WordO 



Words 1 through 177 



Left half The link. The link is the block number of 

the next block in the file. If the link is 
zero, this block is the last in the file. 

Right half A count of the number of words in this block 

that are used (maximum 177). 

Data packed exactly as the user placed it in 
his buffer. 
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Special Prog. Op. Service 

Several prog. ops. are provided for manipulating DECtape. These prog. ops. allow the user to manipulate 
block numbers and to operate upon directories. 



Prog. Op. 



Effect 



USET! D,E 

USETO D,E 
UGETF D,E 



ENTER D,E 
error return 



LOOKUP D,E 
error return 



CALL D, [SIXBIT/UTPCLR/] 



Sets the DECtape on device channel D to input block E 
next. Input operations on this DECtape must not be ac- 
tive because otherwise the user has no way of determining 
which buffer contains block E. 

Similar to USETI but sets the output block number. 
USETO waits until the device is inactive before setting 
up the new output block number. 

Automatically increments the free block pointer, places 
the number of the first unused block in user's location E, 
and does a USETO D,E. 

User's locations E, E+1, E+2, and E+3 must be reserved 
for a directory entry. The DECtape service routine 
searches the directory for a file name and extension that 
match the contents of E and the left half of E+1 . If the 
extension (left half of E+1) is zero, it is not included in 
the search . If no match is found and four free words are 
found at the end of the directory, the service routine 
places the first free block number into the right half of 
E+1 , places the date in E+2 (unless already nonzero), and 
copies the resulting four words into the four free words at 
the end of directory. Then the free block pointer is up- 
dated and a USETO is performed. If a match is found, 
similar actions occur, but the new entry replaces the old. 
If there is no room in the directory, ENTER returns to the 
next location. Otherwise, ENTER skips one location. 

Similar to ENTER but sets up an input file. The contents 
of E and the left half of E+1 (if nonzero) are matched 
against the corresponding words of each directory entry, 
if a match is found, the entire 4-word entry is read from 
the directory into the 4-word block at E . Then a USETI 
is automatically performed using the first block number of 
the file which is found in the right half of E+1 . If no 
match is found, LOOKUP returns to the user's program at 
the next location. Otherwise, LOOKUP skips one location. 

UTPCLR clears the directory of the DECtape on device 
channel D. A cleared directory has word containing 1 
in the left half and 5 in the right half and all other words 
containing zero. Only the directory block (block 1) is 
affected by UTPCLR; the other blocks are unaffected. This 
prog. op. does nothing if the device on channel D is not 
DECtape. 
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In addition to the prog. ops. above, INPUT, OUTPUT, CLOSE, and RELEAS have special effects. When 
performing nondump input operations, the DECtape service routine reads the links in each block to deter- 
mine the next block to read and v/hen to raise the end-of-file flag. 

When an OUTPUT prog. op. is given, the DEGtape service routine examines the left half of the first data 
v/ord in the output buffer (the word containing the word count in the right half) . If this half word contains 
zero, the next free block number is placed there, the free block pointer is updated, and the service routine 
gets set to write in that free block upon the next OUTPUT prog. op. If this half word contains 1 , it is re- 
placed with a before being written out, and the file Is thus terminated. If this half word is greater than 
1 , it is not changed and the service routine uses it as the block number for the next OUTPUT prog. op. . 

For both INPUT and OUTPUT, block 1 (the directory) is treated as an exception case. The "link" in block 
1 is actually the free block pointer and, therefore, is not oltered on output. Thus, if the user's program 
gives: 

USETID,! 
to read block 1, it is treated as a 1 -block file. 

The prog. op. CLOSE places a 1 in the left half of the first word in the last output buffer, thus, termina- 
ting the file. 

The prog. op. RELEAS writes onto block 1 the copy of the directory which is normally kept in core, but 
only if any changes have been made. Certain console commands, such as KJOB or CORE 0, perform an 
implicit RELEAS of all devices and, thus, write out a changed directory even though the user's program 
failed to give a RELEAS. 

Special Status Bits 

If an attempt to write is made on a unit with the write-lock switch on, the device error flag (lODERR) is 
raised. 

Important Considerations 

If an attempt is made to use a unit that is turned off or that has no tape mounted, all DECtape units will 
be hung up until a tape is actually mounted. Good practice is to mount scratch tapes on all transports 
not otherwise in use. 

The DECtape service routine reads the directory from a tape the first time it is required to perform a 
LOOKUP, ENTER, or UGETF. The directory image in core is deleted following the next RELEAS unless 

4-27 



the user assigns a tape unit to his job using the ASSIGN console command. If the unit is assigned, the 
DECtape service routine reads the directory from block 1 only once, the first time it is required and there- 
after uses the directory image in core memory regardless of the appearance of RE LEAS prog. ops. To in- 
form the DECtape service routine that a new tape has been mounted on an assigned unit, the user must use 
one of the console commands IJOB, KJOB, ASSIGN, or DEASSIGN, whichever is appropriate to the 
situation. The directory from the old tape could be transferred to the new tape, thus destroying the infor- 
mation on that tape unless the user reassigns the DECtape transport every time he mounts a new reel. 

Magnetic Tape 
Magnetic tape format is IBM compatible and is not described here. 
Device Name -MTAO, MTAl, ..., MTA7 
Buffer Size - 203 

Data Modes 

A. ASCII - Data is written on magnetic tape exactly as it appears in the buffer. No processing or check- 
summing of any kind is performed by the service routine. The parity checking of the magnetic tape system 
is sufficient assurance that the data is correct. Normally, all data, both binary and ASCII, is written 
with odd parity and at 556 bits per inch. A maximum of 200 words per record is standard. The word- 
count is not written on the tape. 

AL. ASCII Line - Same as A. 

I. Image - Same as A but data consists of 36-bit words. 

IB. Image Binary - Same as I. 

B . Binary - Same as I . 

DR. Dump Records - Variable length records are read into or written from anywhere in the user's core area 
without regard to the standard buffering scheme. Control for read or write operations must be via a com- 
mand list in core memory. The command list format is as described earlier in this chapter under Input/Output 
Prog. Ops, (Dump Mode). For input operations a new record is read for each word in the command list (ex- 
cept GOTO words); if the record terminates before the command word is satisfied, the service routine skips. 



4-28 



to the next command word. If the command word runs out before the record terminates, the remainder 
of the record is ignored. For each output command word, exactly one record is written. 

D. Dump - This mode is accepted but actually functions as DR mode 16. 

Special Prog. Op. Service 

The CLOSE prog. op. performs a special function for magnetic tape. When an output file is closed (both 
dump and nondump), the i/0 service routine automatically writes two end-of-file marks and backspaces 
over one of them. If another file is now opened, the second end-of-file is wiped out leaving one end-of- 
file between files. At the end of the in-use portion of the tape, however, there appears a double end- 
of-file character which is defined as the logical end of tape. When an input dump file is closed, the 
I/O service routine automatically skips to the next end-of-file. 

A special prog. op. called MTAPE provides for such tape manipulation functions as rewind, backspace 
record, backspace file, etc. The format is: 

MTAPE D, FUNCTION 

where D is the device channel on which the magnetic tape unit is initialized. FUNCTION is selected 
according to the following table; 



Function Action 

1 Rewind to load point 

11 Rewind and unload 

7 Backspace record 

17 Backspace file 

3 Write end of file 

6 Skip one record 

13 Write 3 inches of blank tape 

16 Skip one file 

10 Space to logical end of tape 

MTAPE waits for the magnetic tape unit to complete whatever action is in progress before performing the 
indicated function. Bits 18 through 25 of the status word are then cleared, the indicated function is 
initiated, and control is returned to the user's program immediately. It is important to remember that 

4-29 



when performing buffered input/output, the I/O service routine can be reading several blocks ahead of the 
user's program. The MTAPE prog. op. affects only the physical position of the tape and does not change 
the data that has already been read into the buffers. 

Special Status Bits 

Special bits of the status word are reserved for selecting the density and parity mode of the magnetic tape. 
The following bits are set and cleared by the INIT or SETSTS prog. op. . 



Bit 



Name 



Action 



29 



27,28 



26 



lORCK 



lODENS 



lOPAR 



I/O no read check. Suppress automatic error correction 
if bit 29 is a 1 . Normal error correction is to repeat the 
desired operation 10 times before setting an error status 
bit. 



I/O density. 



00 or 10 

01 

11 



=556 bpi 
=200 bpi 
=800 bpi 

I/O parity. for odd parity, 1 for even parity. 



The following bits indicate special magnetic tape conditions and are set by the magnetic tape service 
routine when the conditions occur. 



Bit 



Name 



Meaning 



19 

24 
25 



lODERR 

lOBOT 
lOTEND 



I/O Device ERRor. When set to one during an output 
operation means that the write protect ring is out, 

I/O Beginning of Tape. The tape is at the load point. 

I/O Tape END. The tape is at or past the end point. 



MISCELLANEOUS MONITOR FUNCTIONS 

The following monitor functions provide various user services. All of these functions are obtained by the 
CALL prog. op. using the following format: 

CALL AC, [SIXBIT/FUNCT/] 
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AC specifies the accumulator that either contains an argument for the function or receives the function 
value. FUNCT is the name of the monitor routine v/hich performs the action. 

Date 
The prog, op.: 

CALL AC, [SIXBIT/DATE/] 
loads the date into accumulator AC. The date is compressed into 12 bits by the formula: 

date=((year-1964)*12+(month-l))*31+day-l 

Exit 

The prog, op.: 

CALL [SIXBIT/EXIT/] 

closes and releases all I/O devices, stops execution, prints the message "EXIT" on the user's console, and 
places the console into monitor mode. 

Setddt 

The sequence: 

MOVEl AC, ADR 

CALL AC, [SIXBIT /SETDDT/] 

places ADR into location JOBDDT of the job data area as the starting address used when the user types 
the DDT console command. The user's program cannot alter the contents of JOBDDT except by using the 
SETDDT function because that location is protected by the monitor. 

Setpov 

SETPOV allows the user to program an error correction procedure for pushdown list overflows. The sequence: 

MOVEl AC,ADR 

CALL AC, [SIXBIT /SETPOV/] 

places ADR into location JOBPOV of the job data area. On a pushdown overflow, the monitor traps the 
user's program to location ADR if ADR is nonzero. Location JOBPOV is protected by the monitor and 
cannot be changed except by the use of SETPOV. If SETPOV has not been used and a pushdown list over- 
flow occurs, the monitor stops the user's program and types the following message on the user's console: 

PDL OV AT USER LOC N 
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Swi tch 
The prog, op.: 

CALL AC, [SIXBIT /SWITCH/] 
places the contenl-s of the console data switches Into accumulator AC. 

Timer 

The prog, op.: 

CALL AC, [SIXBIT /TIMER/] 

places the time of day, in 60ths of a second from midnight, into accumulator AC (SOths of a second if the 
power line frequency is 50 cps.). 

Special Loader Function 

The following is a very special purpose loader function and is subject to change or deletion with no ad- 
vance notice. This function is provided for the convenience of the loader. The prog, op.: 

CALL [SIXBIT /LDRBLT/] 

does the following: 

1 . All devices are released. 

2. The contents of accumulator 2 (henceforth referred to as the loader offset) are added 
to the contents of JOBSYM in the offset job data area. 

3. The user's program is assumed to be loaded above the location in which it will run 
by an amount equal to the loader offset. The user's program is block transferred down 
appropriately. The lowest location transferred is 30, the highest is determined by the 
contents of the left half of JOB5A in the offset job data area. 

4. A SETDDT operation is performed on the contents of JOBDDT in the new job data 
area . 

5. The job is stopped and the message: 

LOADER FINISHED 
is typed on the user's console. The console is returned to monitor mode. 

6. The contents of accumulator 2 are set to zero. 
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EXAMPLES 



BEG: 



Typical Program IniHalizaMon 
CALL [SIXBIT /RESET/] 



General Device InlHalization 



INIDEV: 

INIT3,14 
SIXBIT /DTA5/ 
XWD OBUFJBUF 
JRST NOTAVL 



JSR HERE 

BINARY MODE,CHANNEL 3 
DEVICE DECTAPE UNIT5 
BOTH INPUT AND OUTPUT 
WHERE TO GO IF DTA5 IS BUSY 



; FROM HERE DOWN IS OPTIONAL DEPENDING ON THE DEVICE AND PROGRAM 
;REQUIREMENTS 



OBUF: 
INBUF: 
IN NAM: 



OUTNAM: 



MOVE 0, JOBFF 
MOVEM 0,SVJBFF 



CALL AC, [SIXBIT /DATE/] 
MOVEM AC, OUTNAM+2 

INBUF 3, 4 
OUTBUF3,l 
LOOKUP 3, INNAM 
JRST NOTFND 

ENTER 3, OUTNAM 
JRST NOROOM 



JRST@ INIDEV 
BLOCK 3 
BLOCK 3 
SIXBIT /NAME/ 
SIXBIT /EXT/ 







SIXBIT /NAME/ 

SIXBIT /EXT/ 







SAVE THE FIRST ADDRESS OF 
THE BUFFER RING IN CASE THE 
SPACE MUST BE RECLAIMED. 

PUT THE DATE INTO THE DIRECTORY 
ENTRY 

SET UP 4 INPUT BUFFERS 
SETUP 1 OUTPUT BUFFER 
INITIALIZE AN INPUT FILE 
WHERE TO GO IF THE INPUT FILE 
NAME IS NOT IN THE DIRECTORY 
NITIALIZE AN OUTPUT FILE 
WHERE TO GO IF THERE IS NO 
ROOM IN THE DIRECTORY FOR 
A NEW FILE NAME. 
RETURN TO MAIN SEQUENCE 
SPACE FOR OUTPUT BUFFER HEADER 
SPACE FOR INPUT BUFFER HEADER 
FILE NAME 

FILE NAME EXTENSION (OPTIONALLY 0), 
RIGHT HALF WORD RECEIVES THE 
FIRST BLOCK NUMBER 
RECEIVES THE DATE 
UNUSED FOR NONDUMP i/O 
SAME INFORMATION AS IN INNAME 
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General Input One Charact-er Subroutine 



GETCHR: 



GETOK: 



SOSLE IBUF+2 
JRST GETOK 
INPUTS, 
STATZ 3,740000 
JRST INERR 
STATZ 3,20000 
JRSTENDFIL 
ILDB AC, 
JRST@ GETCHR 



JSR HERE 

DECREMENT THE ITEM COUNT 

DATA IS ALREADY IN THE BUFFER 

REFILL THE BUFFER 

CHECK THE 4 ERROR BITS 

WHERE TO GO ON AN ERROR 

CHECK END OF FILE BIT 

WHERE TO GO ON END OF FILE 

FETCH CHARACTER FROM THE BUFFER 

RETURN 



General Output One Character Subroutine 



PUTCHR: 

SOSLE OBUR-2 
JRST PUTOK 
OUTPUT 3, 
STATZ 3,740000 
JRST OUTERR 
PUTOK: IDPB AC, OBUFf 1 

JRST@ PUTCHR 



;SIMILAR TO GETCHR BUT NO END 
;OF FILE CHECKING IS REQUIRED 



Simplified I/O Subroutines 



GETCHR: 



PUTCHR: 



SOSG IBUF+2 

INPUT 3, 

ILDBAC,IBUF+1 

JRST@ GETCHR 



SOSG OBUF+2 

OUTPUT 3, 

ILDB AC, OBUF+1 

JRST@ GETCHR 



Terminating A File 



DROPDV: 



CLOSE 3, 

STATZ 3, 740000 
JRST OUTERR 
RE LEAS 3, 

MOVE 0, SVJBFF 
MOVEM 0, JOBFF 
JRST@ DROPDV 



JSR HERE 

WRITE END OF FILE AND TERMINATE 

INPUT 

RECHECK FINAL ERROR BITS 

ERROR DURING CLOSE 

RELINQUISH THE USE OF THE 

DEVICE, WRITE OUT THE DIRECTORY 

;RECLAIM THE BUFFER SPACE 
;RETURN TO MAIN SEQUENCE 
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Halting A Program 
ENDPRG: CALL [SIXBIT /EXIT/] /CLOSES AND RELEASES ALL DEVICES 

User- Genera ted Buffers 

The following code illustrates avoidance of the JNBUF prog. op. Analogous code may replace OUTBUF. 
This code also illustrates the operation of INBUF. SIZE must be set equal to the greatest number of data 
words expected in one physical record. 



GO: 



MAGBUF: 
BUFl: 



BUF2: 
BUF3: 



INIT 1,0 

SIXBIT /MTAO/ 

XWDO, MAGBUF 

JRST NOTAVL 

MOVE 0, [XWD 400000,BUF1+1 ] 



MOVEM 0, MAGBUF 

MOVE 0, [POINT BYTSIZ,0,35] 

MOVEM 0, MAGBUF+1 

JRSTCONTIN 

BLOCK 3 



XWD SIZE+1,BUF2+1 



BLOCK SlZE+1 





XWD SIZE+1,BUF3+1 

BLOCK SlZE+1 



XWD SIZE+1,BUF1+1 

BLOCK SIZE+1 



INITIALIZE ASCII MODE 
MAGNETIC TAPE UNIT 
INPUT ONLY 

THE 400000 IN THE LEFT HALF 
MEANS THE BUFFER WAS NEVER 
REFERENCED. 

;SET UP NONSTANDARD BYTE SIZE 

GO BACK TO MAIN SEQUENCE 

SPACE FOR BUFFER HEADER 

BUFFER 1, 1ST WORD UNUSED 

LEFT HALF CONTAINS BUFFER SIZE, 

RIGHT HALF HAS ADDRESS OF NEXT 

BUFFER 

SPACE FOR DATA, 1ST WORD RECEIVES 

WORD-COUNT . THUS ONE MORE WORD 

IS RESERVED THAN IS REQUIRED 

FOR DATA ALONE 

SECOND BUFFER 



;THIRD BUFFER 

;RIGHT HALF CLOSES THE RING 



Dump Output 
Dump input is similar to dump output. This routine outputs fixed-length records. 



DMPINI: 



INIT 0,16 

SIXBIT /MTA2/ 



JRST NOTAVL 

JRST @ DMPINI 



JSRHERE TO INITIALIZE A FILE 

CHANNEL 0, DUMP MODE 

MAGNETIC TAPE UNIT 2 

NO RING BUFFERS 

WHERE TO GO IF UNIT 2 IS BUSY 

RETURN 
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DMPOUT: 



DMPDON: 



OUTLST: 



OUTPUT 0, OUTLST 

STATZ 0, 740000 
CALL [SIXBIT /EXIT/] 
JRST@ DMPOUT 


CLOSE 0, 
STATZ 0,740000 

CALL [SIXBIT /EXIT/] 
RE LEAS 0, 
JRST@ DMPDON 
lOWD BUFSIZ, BUFFER 



BUFFER: 



BLOCK BUFSIZ 



JSR HERE TO OUTPUT THE OUTPUT AREA 

SPECIFIES DUMP OUTPUT ACCORDING 

TO THE LIST AT OUTLIST 

CHECK ERROR BITS 

QUIT IF AN ERROR OCCURS 

RETURN 

JSR HERE TO WRITE AN END OF FILE 

WRITE THE END OF FILE 

CHECK FOR ERROR DURING WRITE 

END OF FILE OPERATION 

QUIT IF ERROR OCCURS 

RELINQUISH THE DEVICE 

RETURN 

SPECIFIES DUMPING A NUMBER OF 

WORDS EQUAL TO BUFSIZ, STARTING 

AT LOCATION BUFFER 

SPECIFIES THE END OF THE COMMAND 

LIST 

OUTPUT BUFFER, MUST BE CLEARED 

AND FILLED BY THE MAIN PROGRAM 
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CHAPTER 5 
ERROR DIAGNOSTICS 

MONITOR DETECTED ERRORS 

Whenever a job commits an error so serious that it must be stopped, the monitor types the following pre- 
amble followed by an appropriate message to describe the fault; 

ERROR IN JOB N 

where N is the job number assigned to the offending job. Following the typing of an error message on the 
next line, the monitor returns the console to monitor mode. 

In certain circumstances, such as misuse of the computer console EXAMINE switch to examine nonexistent 
memory, an error occurs while no job is running. In this case the monitor types: 

ERROR IN JOB 

The operator's console is the first console that received typein when the monitor was started (see Appen- 
dix 4) . If the error cannot be explained by someone's misuse of the manual keys, the fault is either a 
monitor bug or hardware failure and should be brought to the attention of Digital personnel. 

ILLEGAL MEMORY REFERENCES 



If the user's program references memory above its core allotment, a hardware-initiated trap to the monitor 
occurs. The exec then stops the user's program and types the following message on the user's console: 

ILL MEMREF AT USER LOC N 

where N is the address of the offending instruction. 

If the user's program attempts to jump to an address above its core memory assignment, the message becomes: 

PC EXCEEDS MEM BOUND AT USER LOC M 
where M is the address to which the user's program jumped. 

The following message occurs only through hardware failure or a bug in the Time-Sharing Monitor. The 
non-existent memory trap causes the monitor to stop the user's job and type the following message on the 
user's console: 
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NON EX MEM AT EXEC LOC N 
or 

NON EX MEM AT USER LOC N 

depending on whether the trap occurred from the user's program or from the exec. The repeated occurrence 
of this message should be reported to Digital personnel . The recommended recovery procedure is to exa- 
mine the memory indicator lamps for memories that are hung up. Clear any such memories and restart the 
monitor. If no such memories are discovered, reload and restart the monitor. 

If the user's program requests the monitor to perform l/O into or from any location above the user's core 
allotment, in the protected portion of the job data area, or (during interrupts) in the accumulators, the 
monitor stops the user's program and types the following message on the user's console: 

ADDRESS CHECK FOR DEVICE X; EXEC CALLED FROM N 

where X is the physical device name and N is the address of the offending prog. op. This error message 
frequently occurs when the user does not have enough core to satisfy all INBUF and OUTBUF programmed 
operators. If the improper memory reference occurs during an interrupt, the form of the message is slightly 
different: 

ADDRESS CHECK FOR DEVICE X DURING INTERRUPT 

This message frequently occurs when the user's program (via a program bug) destroys the ring buffer struc- 
ture so that one buffer in the ring points outside the user's core to the "next" buffer. 

The difference between the ADDRESS CHECK message and the ILL MEM REF message is that the former is 
detected by subroutines in the exec while the latter is detected by hardware. 

ILLEGAL INSTRUCTIONS 



Illegal instructions are all I/O instructions; prog. op. and all undefined prog, ops, above 40; and 
JRST 10, or JRST 4, . All these instructions trap to the exec which stops the user's program and types 
the following message on the user's console: 

ILL PROG. OP. USED AT USER LOC N 

where N is the address of the offending prog, op., or: 

ILL INST AT USER LOC N 

depending on whether the offending instruction was a prog. op. or was a JRST or I/O instruction respec- 
tively. 
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OUTPUT TO AN INPUT DEVICE AND VICE VERSA 

If the user's program attempts output to an input-only device or vice versa, upon the occurrence of the 
faulty INPUT or OUTPUT prog. op. the monitor stops the user's program and types the foliov/ing error 
message on the user's console: 

INPUT DEVICE X CANNOT DO OUTPUT; EXEC CALLED FROM USER LOC N 
or 

OUTPUT DEVICE X CANNOT DO INPUT; EXEC CALLED FROM USER LOC N 

where X is the physical name of the device involved and N is the address of the offending prog. op. 

MONITOR ERROR 

If an undeterminable error occurs, either through a bug in the monitor or hardware failure, the monitor 
stops the user's program that is running at the time of the failure and types the following message on that 
user's console: 

ERROR IN MONITOR AT EXEC LOC N 

This message should be brought to the attention of Digital maintenance personnel . The recovery procedure 
is to reload the monitor and restart. 
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CHAPTER 6 



THE STANDARD CUSP LIBRARY 



THE CONTENTS OF THE CUSP TAPE 

The following is an enumeration of the files found on a standard CUSP tape. Only those programs that are 
not described in separate manuals are covered below in complete detail. Table 6-1 contains a summary of 
the commands and error messages relevant to the most commonly used CUSPs. 

The following programs are found on a stondard CUSP tape. Those labeled "Dump" are loaded by the GET 
console command. Those labeled REL (relocatable binary) are loaded by the binary program loader which 
is itself a dump program. 



Program Name 



Type 



Full Name 



Size 



9KF2 


Dump 


FORTRAN Compiler 
(two-pass version) 


9K 


FOl^ 


Dump 


FORTRAN On-Line Assembler 
(for two-pass FORTRAN) 


9K 


F2 


Dump 


FORTRAN II (one-pass version) 


22K 


MACRO 


Dump 


MACRO Assembler 


9K 


PIPl 


Dump 


Peripheral Interchange Program 
(IK version) 


1 K or more 


PIP2 


Dump 


Peripheral Interchange Program 
(2K version) 


2K or more 


EDITOR 


Dump 


DECtape Editor 


IK 


LOADER 


Dump 


Relocatable Binary Program 
Loader 


IK plus object 
program size 
plus I/O buffers 
for storage map 


DESK 


Dump 


Desk Calculator 


2K 


DDT 


Rel 


Digital Debugging Technique 
(on-line debugger) 


1.5K plus 
symbol table 


JOBDAT 


Rel 


Job Data Area Definitions 


(defines ex- 
ternal symbols 
only) 


FORLIB 


Rel 


FORTRAN operating system and 
subroutine library 


Up to 2.7K 
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Program Name 



Type 



Full Name 



Size 



FUDGE 
RIM DTA 



Dump 
Dump 



File Updating Generator 

RIM Paper Tape to DECtape 
Dump Conversion 



2K or more 

IK plus the 
size of the pro- 
gram being 
copied 



GENERAL CUSP COMMAND FORMAT 

Many of the CUSPs produce output and accept input from all devices. These CUSPs (FORTRAN, FOLA, 
PIP, LOADER) require that the user type in the names of the devices he wishes to use. The typein formats 
for these CUSPs are similar. In general the format is: 

X,X-X,X,X ...^orALTMODE 

where each "X" represents a file descriptor as illustrated below. The files to the left of the left arrow are 
destination (output) files; those to the right are source (input) files. The file descriptors have the follow- 
ing format: 

device:filename. ex tension 

where "device" is the logical or physical name of the desired device, "filename" is a 1- to 6-character 
file name, and "extension" is a 1- to 3-character file name extension. 

For the convenience of the user, the command format may be abbreviated as follows. The file name ex- 
tension need not be typed, in which case the period should also be omitted. For devices other than DEC- 
tape, no file name is required, in which case only a device name followed by a colon must be typed. If 
the device name is omitted, the most recently typed device name is used. Thus to specify more than one 
file from the same device, the user types: 

PTR:,, (three paper tape files) 

PTR:, (two files) 

PTR: (one file) 

DTA3:filel,file2,fiie3 (three DECtape files) 

When a CUSP requires more than one output file, the first file on the left is the binary file (or the Inter- 
mediate file in the case of two-pass FORTRAN) and the second file is the listing file. 

Most CUSPs allow the user to select several options or modes and to perform certain device-manipulation 
functions (such as rewinding magnetic tape). These options, called switches, are selected by typing a 
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single letter preceded by a slash or by typing several letters enclosed in parentheses. Each letter selects 
an option as determined by the particular CUSP being used. For example, to command PIP to copy a 
binary paper tape, the user types: 

PlP}/i- PTR: 
where "B" selects binary mode for PIP. To copy a card file, the user might type: 

DTA2:CARDS(CS) -CDR: 
where "CS" selects both Card input format dnd the insertion of^equence numbers. 

PERIPHERAL INTERCHANGE PROGRAM 

PIPl and PIP2 are programs to transfer data from one I/O medium to another. PIP performs simple editing 
functions during data transmission. 

Size: PIP1=1K or more, PIP2=2K or more (both use all available storage). 
Equipment: Teletype for control, other devices as desired. 
Loading: Run as a user program , 

Operating Instructions 

Commands to PIP are in the standard CUSP format consisting of one output file and any number of input 
files. Nonstandard formats and dump files cannot be copied with PIP. 

P1P2 accepts the switches specified below. PIPl accepts only the switches not marked with an asterisk. 
Switches may appear in the command line anywhere to the left of the first comma (or anywhere if a comma 
is not required). 

if switches are not typed, PIP transmits ASCII data (including sequence numbers if present) from each suc- 
cessive source to the destination, changing only the character following a sequence number to be either 
a tab or a carriage return. Thus, a binary file cannot be copied without the B switch. 



Switch Action 



A ASCII line mode processing. (Do not break up lines between buffers.) 

B Process binary data. 

C* Suppress trailing spaces at the end of each line and change multiple blanks into 

tabs. (Useful for cord input.) 

D* Delete all source file names from the directory of the destination device. The 

destination device name supersedes any other device name that is typed. 
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Switch Action 

F FORTRAN format, one line per record. 

L* List the directory of the source device. Only one source may be specified. 

N Remove sequence numbers. 

R* Rename the source file to have the name of the destination file. No source device 

name is necessary because the destination device is implied. Only one source may 
be specified. 

S A sequence number starting with 00010 and incrementing by 10 is added to the 

front of each line. A tab is inserted after the sequence number unless the line 
consists of form-feed, vertical tab, or line-feed, in which case a carriage-return 
is inserted. If a file is already sequenced, the old sequence numbers are removed. 
Sequence numbers are never split between words and are identified by o one ap- 
pearing in bit 35. 

T* The same as C, except do not replace multiple blanks with tabs. 

W Rewind magnetic tape. Source files are ignored. 

X* Copy an entire DECtape, recovering unused blocks. Empty files are not copied. 

Does not disturb data previously written on the destination tape unless file names 
conflict. Although the source device must be DECtape, the destination may be 
any output device. 

Z Clear the destination DECtape and create a fresh directory. Sources ore ignored. 



When PIP has finished copying a file, it types a carriage-return/line-feed and is ready for the next command. 

Some of the error messages that PIP might type out are: 

DECTAPE INPUT REQUIRED A directory manipulation command (L,R,D) 

was given for a device other than DECtape. 

USE PIP2 One of the * commands was given to PI PI . 

Examples; PI PI and P1P2 

To copy three paper tapes onto one DECtape file, type: 

DTA1:BIGFIL*-PTR:,, 

To do the some as above, but with inserting sequence numbers, type: 

DTA1:BIGFIL/S--PTR:,, 

To list a file, type: 

LPT: *-DTAl:BIGFIL 
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To do the same as above, but stripping off seauence numbers, t/pe: 

LPT:/N- DTA1:BIGFIL 



To rewind magnetic tape: 



To copy binary data; 



To create a fresh directory: 



MTAl :/W ^ 



DTA1:PIP2.REL/B- PTR: 



DTA1:/Z- 



PIP2 Examples: 

To clean up a DECtape and recover unused blocks, mount the source tape on unit 1 and a scratch tape on 

unit 2 (for example). Then type: 

DTA2:/Z - 
DTA2:/X- DATl: 

Return your old tape to the scratch tape supply and take possession of the tape on unit 2, 



To rename files, type: 



To delete files, type: 



To list a directory: 



DTA2NEWNAM.EXT/R- OLDNAM 
DTA2:AFTER/R BEFORE 



DTA2:/D- FILEl, FILE2, FILES 



TTY:/L *- DTA2: 



FORTRAN AND FOLA 

FORTRAN II is implemented in two versions, a 9K version that produces an intermediate, assembly-language 
file which must be assembled in a second pass by FOLA (FORTRAN On-Line Assembler), and a 22K version 
that contains FOLA within itself and produces relocatable binary output in one pass. The 22K version 
accepts all the commands that the 9K version accepts and all the commands that FOLA accepts. 

Size: 9KF2=9K (F2=22K) (FOLA=9K) 

Equipment: Teletype for control, other devices as desired. 

Loading: Run as a user program . 
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Operating Instructions 

For a description of the FORTRAN II language, see programming manual DEC-6-O-TP-Fli-LM-FP-ACTOO. 
The user may specify up to two destination files and any number of source files. File names are in the 
standard format. In general, the command format is: 

For 9KF2: Intermediate File, Intermediate Listings Sources 

For F2: Binary File, Listing -i- Sources 

For FOLA: Binary File, Listing— Intermediate File 

For a listing file only, use the form: 

, Listing "^ Sources 

For no listing, use: 

Binary File, -^ Sources 

To scan for language errors but to produce no output, use: 

, -<- Sources 

Switches 



There are two switches recognized by FORTRAN (marked by *), three by FOLA (marked by **), and three 
recognized by both. All eight are recognized by 22KF2. 



Switch Action 

T* The source is in paper-tape image format. 

M** Do not print a symbol map after compilation. 

Z Clear the directory on the device before inserting the new file. 

R* The source file is a set of FORTRAN II rules instead of source statements. 

K Skip a file before compilation. 

W Rewind before compilation. 

N** Do not put errors on TTY is there is a listing file. 

S** List source only. 

The K and W switches are for mag-tape only. 
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See the PDP-6 FORTRAN II Manual for the differences between card and paper-tape image formats. To 
facilitate using card image format with TTY or PTR input, a tab in columns 1-6 will cause a skip to 
column 7. No colon should appear in columns 1-6. 

More than one switch may be enclosed within parentheses; a single switch may appear ofter a forward slash . 
Any ASCII characters other than the above recognized switches will be ignored. 

The switches N, S, T, M, and R may appear anywhere in the command string before the terminating 
carriage-return. If switch K, W, or Z is desired, it must appear before the terminating character (comma, 
left arrow, or carriage-return) for the desired file. The Z switch is ignored if it appears after the left arrow. 

FORTRAN is normally dumped with a complete set of syntax rules preloaded. The rules need not be read 
in again unless they are changed. If they are to be changed, the compiler need not be reloaded; instead 
"GET" the previous version, and type in the following command string to read in rules: 

(R)DTA1:RULES 
(assuming the rules are on DTAl in a file called "RULES"). The compiler will terminate by calling exit; 
"EXIT" will be typed out. The compiler may then be saved. The writing of syntax rules is described in 
the document. Writing Syntax Rules, DEC-6-00-TP-SC-UM-IP-PRE2. FORTRAN types "EXIT" when 
compilation is complete. The lack of any messages to the contrary indicates there were no errors. FOR- 
TRAN must be reloaded from the CUSP tape to perform additional compilations. 

MACRO 

MACRO is an assembly program featuring a powerful macro-instruction processor and relocatable assembly 
with automatic linking of externally defined symbols at load time. 

Size: 9K (a 13K version is available by special request) 
Equipment: Teletype for control, other devices as desired. 
Loading: Run as a user program. 

Operating Instructions 

For a description of the MACRO assembly language, see programming manual DEC-6-O-TP-MAC-LM-FP- 
ACTOl . The user may specify up to two destination files and any number of source files. File names are 
in the standard format. In general, the command format is: 

Binary File, Listing -^Sources 

For a listing without the binary output type: 

, Listing — Sources 
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For binary with no listing file type: 

Binary File, *- Sources 

To scan for language errors but to produce no output type; 

, -^ Sources 

Switches 

MACRO recognizes the following switches: 



Switch Action 



S Suppress the listing. 

L Reinstate the listing. 

E List macro-instruction expansions. 

X Stop listing macro-instruction expansions. 

F Fix the symbol table so that all symbols currently defined become initial symbols, 

N No error listings on the console. 

A Advance a magnetic tape forward one file. 

B Backspace a magnetic tape one file. 

T Skip to the logical end of a magnetic tape. 

W Rewind magnetic tape. 

Z Clear a DECtape directory . 

The last five switches must be typed immediately following the device specification to which they apply. 

MACRO terminates reading a source file when it encounters the pseudo-instruction TAPE or END. If an 
END statement does not appear before the end of the last source file typed in, MACRO types out the 
message: 

NO END STATEMENT ENCOUNTERED ON INPUT FILE 

Note that a TAPE pseudo-instruction preceding an END pseudo-instruction in the source file hides the END. 



When the assembly is complete, MACRO types: 

END OF ASSEMBLY 
and is ready to assemble another program. 
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EDITOR 

The EDITOR allows the user to make modifications to an ASCII sequenced file on DECtape. Programming 
Manual, DEC-06-TP-EDIT-LM-FP-ACT01 , describes the operating procedures for the EDITOR. 

Size: IK 

Equipment: Teletype for control, one DECtape transport for the edited file. 

Loading: Run as a user program . 

LOADER 

The LOADER allows the user to load binary relocatable programs produced either by MACRO or FORTRAN 
(FOLA). The LOADER links externally defined symbols to the proper addresses, building a table of such 
symbols. This table is available to DDT for user's on-line debugging. 

Size: IK plus the size of the loaded program plus the size of the required symbol table. 
Equipment: Teletype for control, other devices as desired. 
Loading: Run as a user program . 

Operating Instructions 

The general form for commands to the loader is: 

Storage Map File -^Sources 

If the storage map file is never specified and the user requests a storage map, it is typed on the Teletype 
console. 

File specifications are in standard format; however, switches are not in standard format. The characters 
( and / precede switches as in the standard form, but are equivalent to one another. The list of switches 
is terminated by any nonalphanumeric character. A/toreover, certain switches have the same ability to 
separate file descriptors as does comma; these are marked below with an asterisk. 

Switches 

The following switches are accepted by the LOADER: 



Switch Action 

A List all global symbols in storage map regardless of program length. 

D* Load DDT, enter load with symbols mode. 
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Switch Action 

F* Library search FORLIB, exit from load with symbols mode. 

G* Terminate loading, begin automatic library search of FORLIB, list undefined globals. 

An octal number may be typed preceding the "G". The numeric value is used as 
the starting address (if nonzero). The rest of the command line is ignored, 

I Set LOADER to ignore starting addresses in binary input. 

J Set LOADER to accept starting addresses in binary input. 

L Enter library search mode. 

M* Print storage map and undefined list. 

N Leave library search mode. 

P Prevent automatic library search. 

Q Allow automatic library search. 

S Load with local symbols. 

U* List undefined globals on destination file. 

W Load without local symbols. 

X Suppress listing global symbols in zero length programs. 

Z Restart loading. Core cleared, loader set to initial state. The rest of the command 

line is ignored . 



A command string to the loader may consist of one or more lines. A line is terminated by typing carriage- 
return or alt mode. The loader signals readiness to accept one line of console input by typing an asterisk 
at the beginning of the line. Relocatable binary files are loaded in the order the source specifications 
occur. All loading required by one line of a command string occurs after the carriage-return is input, but 
before the asterisk giving the go-ahead to type the next line is output. 

The storage map file may be specified at the beginning of any command line. 

The character ALTMOD has the same effect as the G switch except that no starting address may be typed. 
When the loader is finished, the message: 

LOADER FINISHED 
is typed on the user's console and the console is placed in monitor mode. The user then has the option to 
dump his program using the SAVE monitor command or to start his program by typing START. 
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DESK 

The DESK calculator performs numeric calculations on-line. It features single-precision floating point 
arithmetic, built-in trigonometric and logarithmic functions, and the ability to define functions. Pro- 
gramming Manual, DEC-06-UP-DESK-UM-FP-ACTOl, describes the operating instructions for DESK. 

Size: 2K 

Equipment: Teletype for control and for results. 

Loading: Run as a user program. 

DDT 

DDT provides a powerful on-line debugging language in which the user refers to his program by symbols 
appearing in the MACRO language source program. The operating instructions for DDT are found in Pro- 
gramming Manual DEC-6-O-UP-DDT-UM-FP-ACTOO. 

Size: 2K plus the required symbol table. 

Equipment: Teletype. 

Loading: Load DDT with the LOADER at the same time the program to be debugged is loaded. If DDT is 

to be loaded first, use the D switch to the LOADER as described above. Otherwise, be sure to load with 

local symbols (using the S switch) for those programs which are to be debugged. A suitable command to 

the Loader for loading DDT is either: 

SYS: DDT 



or 



/d; 



The file JOBDAT is included within the DDT file and need not be loaded separately if DDT has been 
loaded. 

NOTE: The DDT file produces about three pages of external symbols on a storage 
map. It is wise to order the loading process so that all required storage maps are 
obtained before DDT is loaded. 

JOBDAT 

The JOBDAT file contains the symbolic definitions of addresses in the job data area. Users' programs that 
refer to the job data area should have all such locations declared as external symbols which are then de- 
fined by the JOBDAT file at load time. 
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Size: 

Equipment: none 

Loading: Load with the LOADER by typing: 

SYS:JOBDAT 

FORLIB 

The file FORLIB contains the FORTRAN operating system and the FORTRAN library of standard functions 
in Linking Loader format. The operating system is described in the document, FORTRAN II Format and 
I/O Processor, DEC-06-OS-FII-GM-FP-ACTOO. The arithmetic functions are described in the FORTRAN 
Langauge Manual, DEC-6-O-TP-FII-LM-FP-ACTOO. 

Size: Between IK and 2K depending on how much of the library is required. 
Equipment: Teletype for error messages and any desired devices. 

Loading: Load by the Linking Loader in library search mode (L switch) after all programs requiring the 
FORTRAN library have been loaded. The loader automatically loads FORLIB from device SYS if unde- 
fined external symbols remain when the command to terminate loading is received. However, the user may 
wish to load FORLIB followed by, say, DDT in which case a suitable command to the LOADER is: 

SYS:FORLIB/L,/D 

FUDGE 

FUDGE is a program for editing relocatable binary files, such as FORLIB, which consist of several inde- 
pendent programs collected into a single file. The operating instructions for FUDGE are given in the 
document. Description and Operating Instructions File Updating Generator (FUDGE), DEC-06-0-UP-LIB- 
UM-FP-ACTOO. 

Size: 2K or more 

Equipment: Teletype for control, any three additional devices, one to receive the edited file, one to 

supply the old master file, one to supply the replacement programs. 

Loading: Run as a user program. 

RIMDTA 

RIMDTA is a user program to read paper tapes in RIM format (see the MACRO manual) and to write out an 
equivalent dump file onto DECtape. The principal use of this program is to read maintenance tapes onto 
a single DECtape for convenient handling. 

Size: 1 K plus the size of the RIM object program . 
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Equipment: Teletype for control, paper tape reader for reading the RIM tape, any output device for the 

output files. 

Loading: Run as a user program . 

Operating Instructions 

Only one file is specified to RIMDTA, the output file. Input from the paper tape reader (PTR) is assumed. 
The output file descriptor is in standard format; no commas, left arrows, or switches are required. The user 
may specify a date in the following format which appears in the directory for each file. 

DE V: F I LN AM . EXT(month/day/year) 

"Month", "day", and "year" are 2-digit decimal numbers. If the file name extension is not specified, 
"DMP" is automatically supplied. 

When RIMDTA is done, it types out either: 

DONE 
or 

TRANSMISSION ERROR. 

"DONE" means that the operation is successful and RIMDTA is ready for the next tape. "TRANSMISSION 
ERROR" means that the attempt to write on DECtape is unsuccessful (often because the WRITELOCK switch 
is in the locked position). 

Files generated by RIMDTA are loaded and run in exec mode by the block Oloaderdescribed in Appendix 4. 
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TABLE 6-1 SUMMARY OF COAAMON USER SERVICE PROGRAMS 



Program 



Size 



Number of 
DEST. Files 



Switches 



Commands 



Error Messages 



EDITOR 


VK 


EDITOR operates 


There are no switches in the EDITOR 


*Typed when ready for a command . 


"*ILC*" Illegal command. 






upon one file 
(sequenced.) 


Special delimitors: 

CR(CARRIAGE RETURN)=Ends a com- 
mand. 


Sx control A (CR)=Select unit x and clear the 
directory. 


"*NLN*" A or D referenced a nonexistent line. 
"*ILS*" The index step (in insert) has caused 








.(POINT)=Has the value of the last 
line number typed. 


Sx, name control A ALT MODE=Same as above 
but creates file "NAME". 


a line already in the file to be skipped. 
"*ILR*" The index step has caused an already 








ALT MODE=Special delineator for S; 


Sx, name (CR)=Open file "NAME" on unit x. 


existing line to be referenced. 








when used alone advances and prints 


Sx, name ALT MODE=Create a new file called 


"*UNA*" DECtape unit is not available. 








the line. 


"NAME" on unit x, 

E(CR)=CLOSE THE CURRENT FILE. 

lnl(CR)=lnsert at line nl . 

lnl,l2(CR)=As above, but set indexing incre- 
ment to [2. 

Dnl(CR)=Delete line nl . 

Dnl , n2 (CR)=Delete line in nl through n2. 

Pnl(CR)=Print line nl . 

Pnl,n2(CR)=Print lines nl through n2. 

Rx(CR)=Resequence the current file. 

Rx,y(CR)=Resequence, stepping by y. 

ALT MODE=Return from text mode to command 
mode, or if in command mode, prints the next 
line. 


"*DCE*" DECtape directory full. 
"*NFO*" No file has been selected. 
"*FAU*" File name already in use. 
"*NCF*" Not a current file. 
"*DDE*" Device data error or write lock. 


PIPl 


1 K Minimum 


1 


A=ASCI1 line. 


General Form: Destination < Source 1 . 


"DEVICE name NOT AVAILABLE" 




(Uses all available 




B=Binary. 


Source 2, . . . . 


"DIRECTORY FULL" 




storage) 




F=FORTRAN format, one line per record. 


DTAl:Big Fil < PTR:,, (Copy 3 paper tape 

files onto DECtape). 


"NO FILE NAMED file name" 








N=Delete sequence numbers. 


DTAl:Big Fil/S < PTR:,, (Same as above 


"OUTPUT DEVICE name DEVICE ERROR" 








S=Sequence. 


but add sequence no.). 


"OUTPUT DEVICE name DATA ERROR" 








W=Rewing mag tape. 


LPT: < DTAl:Big Fil (List the file). 


"OUTPUT DEVICE name IMPROPER MODE" 








Z=Create fresh directory. 


MTA1/W< (Rewind mag tape). 


"OUTPUT DEVICE name BLOCK TOO LARGE" 
"USE PIP2" 
















"INPUT FILE file name DEVICE ERROR" etc. 



6-15 



TABLE 6-1 SUMMARY OF COMMON USER SERVICE PROGRAMS (continued) 



Program 



Size 



Number of 
DEST. Files 



Switches 



Commands 



Error Messages 



PIP2 


2K Minimum 
(Uses all available 
storage) 


1 


A=ASC11 line. 

B=Binary. 

C=Card input suppress trailing spaces. 
Imbedded multiple spaces to tabs. 

D=Delete a file. 

F=FORTRAN format. 

L=List directory of source. 

N=Delete sequence numbers. 

R=Rename source file with name of dest. 

S=Add new sequence numbers. 

W=Rewind mag tape. 

X=Copy and clean up DECtape. 

Z=Create a fresh directory. 

T=Same as C, but without tabs. 


General Form: Same as PIPl, but in Addition: 

DTA2:/X < DTA1: (Copy and clean up). 

DTA2:After/R < Before (Rename A file). 

DTA2:/D < File 1, File 2 (Delete two files). 

LPT:/L< DTA2: (List the directory). 


Same as PIPl and "DECTAPE INPUT 
REQUIRED" 


FOLA 


5K 


2 


N=No error listings on the console. 
S=List source only. 
M=Don't print symbol table. 
W=Rewind mag tape. 
Z=Clear DECtape directory. 
K=Advance forward mag tape one file. 


General Form: Binary, Listing < Source 1, 

Source 2, . . . . 

PTP:, LPT: < PTR: 

DTA2: BINARY, DTA3: LIST < DTAl: 

FOLAIN < DTA3: FOLAIN (No output, 

errors only). 

PTP: < PTR: (Binary onto paper tape, no 

listing). 

,LPT: < PTR: (No binary, listing on 

printer). 


"??"=Command error 

"device name UNAVAILABLE" 

"DEVICE ERROR ON INPUT" 

"DATA ERROR ON INPUT" 

"IMPROPER INPUT MODE ON device name" 

"INPUT BLOCK TOO LARGE ON device name" 

"OUTPUT ERROR" 

"device name DIRECTORY FULL" 

"file name NOT IN DIRECTORY" 

"device name IS NOT A DEVICE" 

"device name CANNOT DO BINARY" 

"NO END STATEMENT ON FINAL PROGRAM" 
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Program 



Size 



Number of 
DEST. Files 



FORTRAN 



9Kor 
22K 



MACRO 



9K 



TABLE 6-1 SUMAAARY OF COMMON USER SERVICE PROGRAMS (continued) 



Switches 



Commands 



T=Teletype or paper tape input. 

R=Read in rules (paper tape image assumed), 

For 22K version, all FOLA switches are 
recognized. For 9K version, only W, Z, 
and K. 



S=Suppress listing. 

L=Reinstate listing. 

E=Expand macros on listing. 

X=Turn off expansion 

F=Fix symbol table. 

N=No error listings on the console. 

A=Advance forward mag tape one file, 

B=Backspace mag tape one file. 

T=Skip to logical end of tape. 

W=Rewind mag tape. 

Z=Clear DECtape directory. 



22K compiler: Binary, Listing < Source 



Ex: DTA3:BINFIL,LPT: ^ 



«- 



DTA2:FORTIN 
PTR:(T) 



(No output, errors only). 

9K Compiler: Fola Input, 

Listing < Source 

Ex: DTA2:FOLAlN,DTAl: LIST<- 
FORTIN (Card image). 



DTA5: 



DTA3:FOLAIN <r 
paper tape input). 



DTA3:FOLAIN <- 
(Teletype image). 



PTR: (No listing, 
DTA1:P1MAGE(T) 



General Form: Binary, Listing < Source 1, 

Source 2, . . . . 

PTP:,LPT:,< PTR:,,, (4 input files). 

■^ DTA3: Macin (No output, errors on 

userTTY). 

DTAl: Bin Out -^ DTA2: Macin (No list- 
ing errors on TTY). 

,LPT: < MTAl: Assemb (No binary). 

DTA2: Bin Out, LPT: < (S)DTA6:MAC1, 

(L)PTR:, (No listing of file MAC!, two files 
from PTR) . 



Error Messages 



Same as FOLA. 



"INPUT ERROR ON DEVICE X" 

"DATA ERROR ON DEVICE X" 

"NO END STATEMENT ENCOUNTERED 
ON INPUT FILE" 

"CANNOT FIND file name" 
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TABLE 6-1 SUMMARY OF COMMON USER SERVICE PROGRAMS (continued) 



Program 



LOADER 



Size 



IK 



Number of 
DEST. Files 



Switches 



Commands 



Errors Messages 



S=Load local symbols. 

W=Do not load local symbols. 

L=Enter library search mode. 

N=Leave library search mode. 

l=lgnore all subsequent starting addresses. 

M=Print storage map. 

Z=Restart loading . 

ALT MOD=Finish loading. Enter L mode 
and load FORLIB if any global symbols 
are undefined . 

A=List all globals including those in zero 
length programs. 

D=Load DDT from SYS Tape. 

F=Leave S mode, enter L mode and load 
FORLIB from SYS Tape. 

Number G=Same as ALT MOD. If number 
"^0, it is the starting address. 

J=Opposite of I . 

P=Prevent automatic library search for ALT 
MOD. 

Q=Opposite of P . 

U=List undefined globals only. 

X=Suppress listing globals in zero length 
programs. 

Normal mode is X, W, N, Q, J. 



General Form; Memory Map ^ Switches, 

Source 1 , . . . . 



LPT: <- 



DTA3: Bl N 1 (S), PTR:,DTA4: USRDDT 



(S)PTR: (Map on user TTY). 



"ILL FORMAT file name" 

"device UNAVAILABLE" 

"INPUT ERROR file name" 

"ILL COMMON file name" 

"EXIT"= not enough core 

"char CHAR. ERROR IN LOADER COMMAND" 

"char SYNTAX ERROR IN LOADER 
COMMAND" 

"char SWITCH ERROR IN LOADER 
COMMAND" 

"n WORDS OF OVERLAP"= n words of extra 
core required 

"symbol n m MUL.DEF. GLOBAL file name" 
where n is the ignored value and m is the real 
value. 

"CANNOT FIND file name" 

"DIR FULL" 
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APPENDIX 1 



MULTIPROGRAMMING EXECUTIVE COMPONENTS 



This, appendix contains a brief functional description of each of the components of the Multiprogramming 
Monitor. This section is intended to convey an idea of the size, function, and organization of the moni- 
tor, but not the complete details on methods of operation. Components sizes are subject to change with- 
out notice. 

DIRECT JOB CONTROL ROUTINES 

These routines are directly associated with processing a user's job. They handle the console communica- 
tions, job scheduling, etc. 



Program Name 



Size (octal) 



Function 



SYSCON 



COMINI 



CORE 
CLOCK 



RUNCSS 
ERRCON 



lOCONT 



252 

135 

100 
144 



270 

425 

477 



Processes UUOs and illegal instructions. Dis- 
patches to the appropriate subroutine for each 
UUO. Returns to the user for user's UUOs. 

Interprets console commands. Dispatches to 
system subroutines to perform the actions re- 
quested. 

Processes all core allocation requests. 

Handles processor interrupts. Calls the schedul- 
ing algorithm to schedule d new job. Dispatches 
to error routines for job error traps. Processes 
the clock queue. 

Controls the actual starting and stopping of jobs. 

Transmits error messages to the user's console. 
Interprets error conditions. 

Processes the standard input/output UUOs. 
SYSCON dispatches to this program. 



EXECUTIVE DATA STORAGE 

These routines provide data storage tables for the various system functions. These storage tables define 
the system configuration and (together with the accumulators) the state of the monitor program. 
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Program Name 



Size (octal) 



Function 



lOINIl 



IOINI2 



JOBDAT 



443 



2636 
(DEC config) 



Contains all system tables and temporary regis- 
ters except those for the I/O modules. Also con- 
tains the priority interrupt processing subroutines. 

Contains all tables for the I/O subroutine mod- 
ules. The size of this program is highly dependent 
on system configuration. 

Defines the names of locations in the user's job 
data area. 



INTERNAL EXECUTIVE SUBROUTINES 



These programs contain subroutines and other useful functions that ore called from other system programs. 

Performs the scheduling algorithm. 

Contains subroutines that are used throughout the 
I/O service modules. 

Processes the miscellaneous system UUOs. 

Processes console commands. COMINI dispatches 
to this program. 

Contains subroutines used in processing console 
commands. 

Processes the two console commands, SAVE and 
GET. 



CLKCSS 


102 


iOCSS 


401 


SYSCSS 


35 


COMCON 


272 


COMCSS 


234 


SAVGET 


164 



SPECIAL PROGRAMS 

The following programs perform system initialization and system debugging. They are not normally refer- 
enced during time-shared operations. 



SYSINI 



ONCE 



SYSMAK 



no 

563 
36 



DDT 



3203 



Initializes executive storage areas. Processes 
manual restarts. Initializes I/O modules. 

Processes the initial conversation in which the 
operator types in the day and the time. 

Moves the core image for job number one down 
on top of the monitor to the corresponding abso- 
lute locations. This program permits nonuser 
programs to be loaded by the time-sharing loader 
and to be run in exec mode. 

The executive debugging program. The space 
SYSMAK and DDT occupy may be used as 
additional user's program area. 
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Program Name 



Size (octal) 



FuncHon 



I/O SERVICE MODULES 

The following programs process I/O service requests and device interrupts for the various devices that may 
be used during time-sharing. 



SCNSER 



DTSER2 



LPTSER 

CDRSER 

PTPSER 

PTRSER 

MTPSER 



1163 



1305 



141 
244 
231 
140 
551 



Controls the console Teletype and up to 64 lines 
on the Data Communications System Type 630, 
both full and half duplex. Processes console 
communications with the monitor. 

Controls up to eight DECtape transports on one 
DECtape Control Type 551 . Interlocks with the 
magnetic tape service module for the use of the 
data control . 

Controls one Line Printer Type 646. 

Controls one Card Reader Type 461 . 

Controls one Paper Tape Punch Type 761 . 

Controls one Paper Tape Reader Type 760. 

Controls up to eight magnetic tape transports on 
one Magnetic Tape Control Type 516. Interlocks 
with the DECtape service module for the use of 
the data control . 
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APPENDIX 2 
MONITOR SCHEDULING ALGORITHM 



The objective of the scheduling algorithm is to keep the i/0 devices as busy as possible while still giving 
users good response for short computations. To do this the monitor keeps track of which jobs are runable 
and which are not. At least every 17 msec the monitor reviews the situation and decides whether or not 
to continue running the current job. This is done by keeping the runable jobs in a queue and serving them 
in a round robin manner with the head of the queue always being run, vVhenever an unrunable job be- 
comes runable it is placed at the front of the queue and is assigned a fixed quantum of time depending on 
the reason it became runable. It will then be run at the next scheduling period which can never be more 
than 17 msec away. Whenever the head of queue job exceeds its quantum, it is reassigned a somewhat 
longer quantum of 250 msec and is placed at the end of the queue. 

Jobs may become runable for any of the following reasons: 

1 . The user typed a console command which started execution such as START, CONT, 
STARTC, CONTC, or DDT. He is given a 100-msec quantum. 

2. The job just completed waiting for some of its own input/output to finish. It is 
given a 100-msec quantum. 

3. The job just completed waiting for some other job's input/output to finish on a device 
which must be shared in a serial manner such as the magnetic tape control, the DECtape 
control, or the data control. The job is given a 70-msec quantum. 

The effectiveness of a time-sharing system depends to a great extent on the program scheduling strategy 
used. Realizing this, the entire scheduling algorithm has been incorporated Into a single separate sub- 
routine. Thus, it may be changed easily to meet the needs of a particular computer installation. 

The program name of this subroutine is CLKCSS and its only entry point is NXTJOB. Its sole function is 
to return the job number of the highest priority job at that instant. If no job is runable, it returns 0, the 
so-called null job which counts in AGO and runs with the PC at 1 . NXTJOB is called on the following 
occasions: 

1 . Every 60th of a second . 
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2. Whenever the current job is forced to wait for I/O or is stopped by the user at his 
console ('control' C) . 

3. Whenever any job becomes runable while the null job is running. 
For further details consult the assembly listing of the subroutine itself. 
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APPENDIX 3 



SYMBOL DEFINITIONS 



OPDEF TAPE FOR EXEC SYSTEM 



OPDEF ENTER 


[ 77 B8] 


OPDEF LOOKUP 


[76B8] 


OPDEF USETO 


[75B8] 


OPDEF USETI 


[74B8] 


OPDEF UGETF 


[73B8] 


OPDEF MTAPE 


[72B8] 


OPDEF RELEAS 


[71B8] 


OPDEF CLOSE 


[70B8] 


OPDEF OUTPUT 


[67B8] 


OPDEF INPUT 


[66B8] 


OPDEF OUTBUF 


[65B8] 


OPDEF INBUF 


[64B8] 


OPDEF STATZ 


[63B8] 


*OPDEF STATUS 


[62B8] 


OPDEF GETSTS 


[62B8] 


OPDEF STATO 


[61 B8] 


OPDEF SETSTS 


[60 B8] 


OPDEF INIT 


[41B8] 


OPDEF CALL 


[40B8] 



OPDEF'S FOR FORTRAN OPERATIONS SYSTEM 



OPDEF RESET. 


[15B8] 


OPDEF IN. 


[16B8] 


OPDEF OUT. 


[17B8] 


OPDEF DATA. 


[20B8] 


OPDEF FIN. 


[21 B8] 


OPDEF RTB. 


[22B8] 


OPDEF WTB. 


[23B8] 


**OPDEF REW. 


[24B8] 


OPDEF SLIST. 


[25B8] 


OPDEF INF. 


[26B8] 


OPDEF OUTF. 


[27B8] 


OPDEF RERED. 


[30B8] 



* Obsolete name 

**The following UUOs have the same definition as REW.: REWUN,, BSR., WEF., SPR., and WBR. 
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TITLE JOBDAT - JOB DATA AREA ASSIGNMENTS 
SUBTTL 8-2-65 

DEFINE BLK (A,B) 

<JOBPR0=B 

A=0 

ENTRY A 

DEFINE BLK (G,D) 

<C=JOBPRO 

JOBPRO=JOBPRO+D 

ENTRY C>> 



BLK JOBAC,20 
BLK JO8DAC.20 

J0BDHI=J0BDAG+17 

BLK JOBUUO.l 
BLK J0B41,1 
BLK JOBPC.l 
BLK JDBPOP.l 

JOBPRTsJOBPDP 

J0RPR1=J0BPRT+1 

BLK JOBREL.l 
BLK J08UXT.1 
BLK JOBLEV.l 
BLK JOBSaV.I 
BLK JOBPOV.l 
BLK JOBTEM.l 
BLK JOBTMl.l 
BLK JOBINF.l 
BLK JOBJDA,20 
BLK JOBDOT.l 

JOBPFIsJOBDDT-1 

JOBPFUsJOBDOT 

BLK JOBCDP.l 
BLK JOBTRP,20 
BLK JOBSYM.l 
BLK JOBUSY.l 
BLK J08SA,1 



JORDAT 

JORHGH 

JORPDL 

JORPDl 

MJOBPO 

J0BS41 

JOBDA* 

ENTRY 

ENTRY 



BLK JOBFF.l 
= 140 

=J0BDAT-1 
=J0BPR0-1 
sJOBPDL+1 
=JOBPDL-JOBHGH 
sJOBPRO 



;SYSTEM USE AC STORAGE 
;USER'S AC STORAGE WHILE 
;HIGHEST AC SAVED WHILE I 
;UUO SAVE AND TRAP LOCATI 
JUUO JSR LOCATION 

;bits 0-5=apr flags, CCRH 
;push down pointer for sy 

;FIRST LOC PROTECTED FROM 
FIRST LOC+1 

C(LH)=0, C(RH)sRELOCATI0 
EXIT FROM UUO AT BREAK 
C(40) WHEN INACTIVE 
TEMPROARY STORAGE FOR UO 
PUSH DOWN OVERFLOW TRAP 
(UNUSED)TEMPORARY SYSTEM 
n 

UNUSED 

JOB 10 DEVICE CHANNEL AS 
ADDRESS OF USER'S DDT 
LAST LOC PROTECTED FROM 
LAST LOC PROTECTED FROM 
(UNUSED)POINTER TO COMMA 
(UNUSEO)TRAP LOCATIONS 
SYMBOL TABLE POINTER 
(UNUSED)POINTER TO UNDEF 
C(RH>=STARTING ADDRESS 
C(LH)=HIGHEST LOCATION U 
FIRST FREE LOCATION 

;length of JOB data area 

;highest LOC in job data 

JFIRST LOC. -1 OF PD LIST 
;FIRST LOC. IN PD LIST 
i- LENGTH OF PD LIST 
JPLACE WAHERE SaVE-GET SA 



job IS INACTIVE 

nactive 

ONS 

)=PC 

STEM USE 
INTERRUPT SERVICE 



N ADDRESS 

HANDLER 
STORAGE 

SIGNMENTS 

10 SERVICE 

USER 

NO STRING 

INED SYMBOL TABLE 
SED 

AREA 

VES USER LOC 41 



JOBDAT 

J08PFI,J0BPFU,J0BPDL,J0BPR0,MJ0BPD.J0BHGH 

J0BDHI,JOBPRT,J0BPRl.J0BDA.J0BS41,J0BPDl 

END, 
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System Parameters 
XLIST 



DEFINE 



XP(A,B) 
<A = B 
INTERNAL 



.ACCUMULATORS 

XP IOS,0; 

XP TAC.l; 

XP TAC1.2; 

XP pdP,3; 

REPEAT 0,< XP SUB 

> 

XP TEM,10 

XP ITEM, 4; 

XP DAT,5S 

XP 0EVDAT,6; 

XP jbuf.oat; 

XP PROG, 7; 

XP JDAT,li; 

.ONLY TO 10 NORMALLY 
.FOR INTERRUPT SERVICE 

XP BUFPNT,12; 

XP 8UFWRD,13; 



XP UU0,14; 

XP AC1,15 

XP AC2.16 

XP AC3,17 



5SYSTEM PARAMETER 



10 STATUS WORD 
TEMPORARY 
TEMPORARY 

C{LH)=NUMBER OF LOCATIONS LEFT IN PD LIST 
C(RH)=PUSHOOWN POINTER 
10 RETURN (PC) FOR ONE LEVEL SUBROUTINES 



BYTE OR WORD POINTER. ITEM COUNT 

DATA OR TEMPORARY 
C<LH)=UNUSED. 

C(RH)=AODRESS OF DEVICE DATA BLOCK 
ADDRESS OF JOB BUFFER AREA=JBFAOR 

C(LH)=UNUSED 
C(RH)sADDRESS OF USER'S PROGRAM AREA 
C(RH)=AOORESS OF JOB DATA 
REQUIRED 

C(JBFADR 18-35) 

BIT 0=IOUSE 

BITS 1-17SBUFFER SIZE 

BITS 18-35=NEXT BUFFER ADDRESS 

LAST UUO PROCESSED 

{TEMPORARY ACS(MORE TEMPORARY 

JTHAN TACTACl) 
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, DEVICE DA 
XP 



XP 
XP 

DEVICE 
XP 
XP 
J IM 



XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 



TA BLOCK NAMES 

OEVNAM,0; NAME IN SIXBIT ASCII 
C(LH)=OEVICE MNEMONIC 
C(RH>=OEVICE NUMBER, LEFT JUSTIFIED 
CHARACTERISTIC 
BITS 0-8=JOB NUMBER 

ZERO VALUE IMPLIES NOT ASSIGNED 
BITS 9-ll=Pr PRIORITY CHANNEL FOR DEVICE 
{RIGHTMOST BIT OF PI CHAN. FIELD 
BIT 12=UNUSED 
BIT 13=I0RET. IF DEVICE HAS A SHORT 

DISPATCH TABLE. 1 IF LONG 
;F0R RETRIEVABLE DEVICES. 
DISPATCH TABLE =0. LONG = 1 
BITS 14-17=J0B DEVICE CHANNEL NUMBER 
BITS 18-23=DEVICE NUMBER. BINARY 
BITS 24-35=BUFFER SI2E 
21 STATUS WORD. SEE BELOW 

3; C(LH)=NEXT DEVICE DATA BLOCK 

C(RH)=DEVICE SERVICE DISPATCH TABLE 
CE DISPATCH TABLE ASSIGNMENTS 

XXXDSP : RELEASE 
XXXDSP *i: CLOSE 
E ADDRESS PART OF CLOSE UUO 



XP DEVCHR.l 



XP PICHN,100 



XP IORET,20 

JSHORT 



DEVIOS, 
DEVSER, 

SERVI 

DRL.0; 

DCL.i; 

MEOIAT 
X 
X 

D0U.2; 

DIN. 3; 

0EN,4J 

0LK,5; 

000,6; 
001,7; 

DSO.10 
OSI.ll 
DGF,12 
DEVMOD 



CLSOUT.l 
CLSIN,2 



INHIBIT 
INHIBIT 



CLOSING 
CLOSING 



OUTPUT 
INPUT 



OUTPUT 

input;short 

ENTER 
LOOKUP 
DMPO 
DMPI 



; irght half 

XP 
XP 

;lfft half 

XP 
XP 
XP 
XP 
XP 
XP 

XP 
XP 
XP 
XP 
XP 



OF DE 
ASSCON 

assprg 
device 

OVOUT, 
DVIN,2 
DVOIR. 
OVTTY, 
OVMTA, 
DVAVAL 



;bit 19 
vice mode word 

.400000 
.200000 



XXDSP +2: 

XXXDSP +3: 

XXXDSP +4: 

XXXDSP +5: 

XXXDSP +6! 

XXXDSP +7: 
XXXOSP+10; SETO 
XXXOSP+li: SETI 

xxxDSp+12: getf;long dispatch 

IBITS 6-ll=LEFT HALF OF IMAGE MODE 
;BIT 35-J=1 if MODE J IS LEGAL FOR 
;BIT 18 DEVICE ASSIGNED BY CONSOLE 
DEVICE ASSIGNED BY PROGRAM 



DISPATCH TABLE 



TABLE 

BYTE POINTER 

THIS DEVICE 

COMMAND 

(INIT) 



;ASSIGNED BY CONSOLE COMMAND ASSIGN 
;aSSIGNED BY PROGRAMdNIT UUO) 



CHARACTERrSTICS(OEVCHR UUO) 
1 ;OUTPUT DEVICE 

; INPUT DEVICE 
4 ;HAS A DIRECTORY 
10 ; IS A TTY 
20 ;IS A MAG TAPECREWIND) 
,40 ;i IF DEVICE IS AVAILABLE TO THIS JOB 

;SET BY DEVCHR UUO 

;TTY DOB IN USE FLAG 

;TTY ATTACHED TO JOB IF 1 

J IS A LPT (CARRIAGE CONTROL IN FORTRAN) 

;IS A CARD READER(TRAILING SPACES FOR MACRO) 



TTYUSE 

TTYATC 

DVLPT 

DVCOR 

DVDIRIN. 400000 



:. 10000 
20000 
40000 
100000 



;directory in core if i 



XP devlog,5; 
XP devbuf,6; 

XP DEVIA0,7; 



logical NAME FOR JOB DEVICE 
C(LH)=OUTPUT BUFFER AREA DDRESS 
C<RH)=INPUT BUFFER AREA ADDRESS (JBFADR) 
C(LH)=:PROG IN INDEX FIELD 
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XP OEVADR.DEVIAD 

C(RH)=CURRENT INPUT BUFFER ADDRESS 
XP DEVOAD.ia; C<LH>=PROG IN INDEX FIELD 
XP OEVPTR.DEVOAD 

C(RH>=CURRENT OUTPUT BUFFER ADDRESS 
XP OEVCTR.IU 
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, 1/0 

.DATA 



STATU 
MODES 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
, STATUS BI 
»RIGHT HALF 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
HALF 
XP 
XP 
XP 
XP 
XP 
XP 
XP 



LEFT 



S WORD 

BITS 
A,0: 
AL.i; 
1,10; 

18,13; 

8,14? 
OR, 16 
D,17 
TS 

(USER) 
IOWC,20 
I0G0N,4 
lORDEL, 
lONRCK, 
lODEND, 
lOOERR, 
lOOTER, 
lOIMPM, 
lOBKTL, 
lOACT.l 

(SYSTE 
lOW.lJ 
I0BEG,2 
lODISC, 
I0FST,4 
lOSTRT, 
10,20; 
I0END,4 



ASSIGNMENTS 
32-35 

ASCII 



IMAGE 

;dump 



ASCII LINE 

IMAGE 
BINARY 

BINARY 

;DUMP by RECORDS 
ACROSS RECORDS 



; DON'T COMPUTE WORD COUNT 

0; CONTINUOUS (CONT=0) 

100; READ AND DELETE 

100; READ WITH NO. REREAD CHECK 

20000; DATA END ENCOUNTERED 

200000; DEVICE ERROR 

100000; DATA ERROR 

400000; IMPROPER MODE REQUESTED 

40000; BLOCK TOO LARGE 

0000; DEVICE ACTIVE 

M) 



; VIRGI 

400000; 

NEXT 
10; 10 RE 



0; 



I/O WAIT 
N DEVICE 

DISCONNECT REQUEST 
ITEM WILL BE THE FIRST ITEM OF A BUFFER 
ADY TO START 

OUTal, IN=0 
SERVICE ROUTINE HAS TRANSMITTED LAST DATA 



iLFFT 



CLOSE 



HALF 
XP 
XP 
XP 
XP 
XP 
XP 
XP 
XP 

UUO 
XP 
XP 



USRJDA (JOB DEVICE 
INITB, 400000; 
IBUFB, 200000; 
OBUFB. 100000; 



ASSIGNMENTS) 
INIT 

INIT WITH 
INIT WITH 



LOOKB,4PI000; 
ENTRB, 20000; 
INPB. 10000; 
OUTPB,4000; 
CLOSB,2000; 

BITS 

CLSOUT.l 
CLSIN,2 



LOOKUP 

ENTER 

INPUT 

OUTPUT 

CLOSE 



UUO'S FOR THIS CHANNEL SINCE LAST INIT 

INPUT BUFFER SPECIFIED 
OUTPUT BUFFER SPECIFIED 



;release clears them all 



INHIBIT 
INHIBIT 



CLOSING 
CLOSING 



OUTPUT 
INPUT 
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JOB RUFFER AREA HEADER 

XP JBFADR,0; BIT 0=1 IF THIS BUFFER RING HAS NEVER BEEN 

REFERENCED FROM THE USER'S PROGRAM BY 
AN INPUT OR OUTPUT COMMAND. 
BITS 1-17=UNUSED 

BITS 18-35=CURRENT BUFFER ADDRESS 
XP JBFPTR,!? BYTE POINTER TO NEXT BYTE -1 
XP JBFCTR,2; POSITIVE ITEM COUNT 
JOB BUFFER HEADER BIT 0=IOUSE 

XP lOUSE. 400000; 1 IF BUFFER IS FULL (OR BEING EMPTIED) 

IF BUFFER IS EMPTY (OR BEING FILLED) 
BITS 1-17=BUFFER SIZE 
BITS 18-35=NEXT BUFFER ADDRESS 
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.SYSTEM PARAMETERS 

XP USRMOD, 10000; USER MODE BIT IN ARP FLAGS, PC WORD 

XP IODONE,40W000; 
.JOB STATUS WORD (JBTSTS) 

XP lows, 400000; 10 WAIT SATISFIED 

XP RUN. 200000; READY TO RUN OR IS RUNNING 

XP JIOW, 100000; JOB IN lO-WAIT STATE 

XP DTW, 40000; DECTAPE CONTROL WAIT . 

XP DCW, 20000; DATA CONTROL WAIT 

XP MTW, 10000; MAG TAPE CONTROL WAIT 

XP JNA,4000; JOB NUMBER ASSIGNED 

XP JERR,2000; JOB ERRORdLLEGAL MEM. ETC.) 

XP RUNABLE.RUN+JNA; status bit pattern for a JOB TO STAY RUNABLE 
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{SPECIAL ABSOLUTE LOCATIONS IN LOWER MEMORY 

{THESE ARE INTENDED TO BE EXAMINED AND CHANGED BY 

;USING THE DATA SWITCHES BEFORE SYSTEM IS STARTED AFTER BEING LOADED 

;ONLY TODAY AND BCDTIM NEED BE SET 

;ALL others are assembled in AND SHOULD BE SET ONLY IF A CHANGE IS DESIRED 

XP D0TMEM,37 ;MEMORY SIZE FOR SYSTEM DDT AND SYSMAK ONLY 

XP DDTSYM,36 JSYSTEM DDT SYSBOL TABLE POINTER (USED TO BE 77) 

, SYSTEM MACROS 

DEFINE ADRCHK (A) 

< EXTERNAL ADRCK 

DEFINE ADRCHK (B) 

<PUSHJ POP, ADRCK 

HRRZ TAC,B> 

PUSHJ POP, ADRCK 

HRRZ TAC,A> 

LIST 
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APPENDIX 4 
MONITOR OPERATING INSTRUCTIONS 

PROCEDURE FOR LOADING THE MULTIPROGRAMMING MONITOR 

1 . Turn on the computer (POWER switch on console). This should also send power to 
all of the I/O devices. 

2. Check to see that the power is turned on for all I/O devices. 

3. Place DECtape copy of monitor on drive 0. (Set the DECtape unit selection switch 
to 8 to get unit 0). Make sure no other units are set to 8, 

4. If machine does not have fast accumulators: 

a. Assume that the 10 instruction Read-in Mode Loader is still in locations 20 
through 27. (It usually is.) 

b. Depress the READER OFF lever switch. 

c. place a RIM paper tape copy of the DECtape RIM Loader in the reader. 
(See DEC 06 L DTRL UML FP ACTOO Shadow AAode Loader for a listing of this 
14-instruction program.) 

d. Turn on the reader. 

e. Set the ADDRESS switches to 20 and depress the INSTRUCTION STOP, 
I/O RESET, and START lever switches in that order. The 10 instruction Read- 
in Mode Loader will load the 14-instruction DECtape RIM Loader into loca- 
tions through 13 and then stop. 

f. Depress the INSTRUCTION CONTINUE lever switch. The DECtape RIM 
Loader will then load the DECtape Block Loader from block of unit into 
locations 37400-37777. 

g. If the paper tape does not move when the START lever switch is depressed, 
the assumption that the 10 instruction Read-in Mode Loader was intact proved 
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to be valid. It must be keyed into locations 20 through 27 using the DATA and 
ADDRESS switches and the DEPOSIT lever switch. The Read-in Mode Loader is; 



20/ 


710600 000060 


CONO PTR, 60 


21/ 


710740 000010 


CONSO PTR, 10 


22/ 


254000 000021 


JRST .-1 


23/ 


710440 000026 


DATAl PTR, 26 


24/ 


710740 000010 


CONSO PTR, 10 


25/ 


254000 000024 


JRST .-1 


26/ 


irrelevant 




27/ 


254000 000021 


JRST 21 


Go back to step 4a. 







5. If machine has fast accumulators: 

a. Assume that the DECtape RIM Loader is still in locations through 13 of 
shadow mode memory. (It usually is.) 

b. Set the ADDRESS switches to 0, depress the INSTRUCTION STOP and lift 
THE START lever switch. 

c. The 14-instruction DECtape RIM Loader will then load the DECtape Block 
Loader from block of unit 0. 

d. If block is not loaded, the assumption that the DECtape RIM Loader was 
intact proved invalid. To restore it to locations through 13 of shadow mode 
memory, flip on the RIM MAINTENANCE switch in bay 2, so that the RIM 
SUBR light on the panel on bay 1 is on. 

e. Load the DECtape RIM Loader from paper tape into locations through 13. 
See steps 4a through 4e. Do not press INSTRUCTION CONTINUE (step f). 

f. Turn the RIM MAINTENANCE switch off so that the RIM SUBR light is off. 
Go back to step 5a. 

6. Instruct the DECtape block loader to load the dump file which contains the 
monitor by typing the file name (name of the installation) followed by carriage- 
return on the console Teletype. The file directory on block 1 will be searched, and 
the specified dumpfilewill be loaded into core. The dumpfilemust be a program 

less than 16K. If the dumpfileis not In the directory, a bell will be typed to indicate 
the error. 



A4-2 



7. Line-feed will be, typed out after the file has been loaded. Now set the ADDRESS 
lever switches to 140 and depress the INSTRUCTION STOP, I/O RESET, and START 
lever switches in that order. 

8. The monitor will then enter a once-only dialogue with the operator on the console 
Teletype (CTY). The monitor will request various pieces of information like the date 
and time of day. The operator must type in this information followed by a carriage- 
return. A line-feed will be echoed. Rubouts work as in time-sharing and may be used 
to delete erroneous typing. Typing in carriage-return while monitor is typing out will 
terminate the line, thereby speeding up the startup procedure. 

9. The once-only dialogue looks like the following with output indicated by *: 

*DEC 1 .4 10-13-65 MONITOR JUST LOADED 
* TYPE TODAY'S DATE AS ABOVE. 

(operator types date) 
*TYPE 4 DIGIT TIME. 

(operator types time) 
*l/0 CONFIGURATION 
*10TTY'S 
*8 DTA'S 

etc 
*DO YOU WANT SYSMAK (TYPE Y IF YES, CR IF NO)? 

(operator types Y or CR) 
*EXEC DDT? 

(operator types Y or CR) 
*EXEC IS 13573 OCTAL LOCATIONS LONG. 

10. The monitor sets its system data storage to 0. 

11 . The monitor examines all 256K of memory to find which are nonexistent. A memory 
with the power turned off will appear nonexistent and will not be used by the monitor. 

12. All I/O devices are initialized 

13. The PI channels are turned on and time-sharing may begin. Whenever the monitor 
has nothing to do, it will run the null job. The null job counts in ACO and runs in ACl . 
Therefore, it can be detected by a 1 appearing in the PROGRAM COUNTER lights while 
the machine is in EXEC mode. The count in ACO may be displayed by setting the ADDRESS 
switches to 0. The count is reset every time the null job begins to run, so that it can be 
used to estimate the system idle time. 



A4-3 



14. The operator types DEASSIGN OPR which initializes job 1 and deassigns his Teletype. 
The operator's Teletype is given the name OPR and is defined as the first Teletype on 
which a character is typed in after the PI is turned on. Usually it is CTY. 

15. The operator mounts the CUSP tape on drive and sets it to WRITE LOCK. 

16. The operator mounts console scratch tapes on all other drives, and sets them to 
WRITE. Make sure that all units are dialed to unique numbers starting at (8). The 
system will hang up if a user attempts to use a unit on which no tape is mounted or the 
power is off . 

17. Remote users may then communicate with the operator by using PI PI in the following 
manner: 

CORE 1 

GET SYS:P1P1 

START 

OPR: - TTY: 

the message 

<control> Z 

The message should begin with a few bell characters to attract the attention of the operator. 
To receive an acknowledgement the message should end with GA (go ahead). Then the 
user should type the following PIP command string: 

TTY: - OPR: 

The operator will not need to know from which Teletype the message was typed. 

This interconsole message communication is most useful to request the operator to mount 
a tape on a drive previously ASSIGNED to the user by the ASSIGN command. It is also 
useful for requesting a tape to be set to WRITE or WRITE-LOCK. Example of a typical 
sequence of commands for remote users. Input is indicated by underline. 



User's Console 



Operator's Console 



ASSIGN DTA 
DEVICE DTAl ASSIGNED 
JOB 2 INITIALIZED 
DEC 1.4H 

CORE 1 



DEASSIGN OPR 

JOB 1 INITIALIZED 

DEC 1.4H 
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User's Console 



Operator's Console 



GET SYStPIPl 
JOB SETUP 

START 



OPRt*-TTY; 
<bell><bell><bell> 

PLEASE MOUNT TAPE 39 ON UNIT 1 

SET TO WRITE GA 

12 



TTYt-OPR; 



TAPE MOUNTED. 



PLEASE MOUNT TAPE 39 ON UNIT 1 
SET TO WRITE GA 

TAPE MOUNTED. 
11 



Yellow 

Green 

Red 



DECtape Colored Label Conventions 

Console Scratch 

System tapes CUSP + AAonitor 

Private tapes 



ERROR RECOVERY PROCEDURES 

Occasionally the system may hangup. If this happens, a software trouble report should be filled out and 
sent to Digital Equipment Corporation, Maynard, Mass., attention: PDP-6 Librarian. Prompt replies are 
sent back regardless of whether the trouble is hardware or software. 

The error recovery procedure consists of restarting the monitor which will reinitialize part of itself before 
resuming operation. There are four restart procedures which reinitialize an increasing amount of the 
monitor. 

1 . To recover from a priority interrupt which will not dismiss (PI in PROGRESS lights on 
continuously): 

a. Press STOP lever switch. 

b. Fill out software trouble report. 

c. Set ADDRESS switches to 144. 

d. Press START lever switch . 
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This action tries to dismiss interrupt and start running null job. This affects at most one 
job which the user will have to restart, 

2. To recover from hung I/O devices, wait until all users have finished their immediate 
operations. For example, all users editing should type the E editor command. 

a. Press STOP lever switch. 

b. Fill out software trouble report. 

c. Press I/O RESET lever switch. 

d. Set ADDRESS switches to 140. 

e. Press START lever switch. 

This will not reenter once-only dialogue. It will not DEASSIGN any devices and will 
not return core to the system. All Teletypes will be in command mode, and each user 
must type the START monitor command to restart his job. 

3. To reinitialize the monitor to the state it was in just after being loaded: 

a. Press STOP lever switch. 

b. Fill out software trouble report. 

c. Press I/O RESET lever switch. 

d. Set ADDRESS switches to 143. 

e. Press START lever switch. 

Step 10, 11, and 12 of the monitor loading procedure must be repeated and all jobs 
reloaded . 

4. To recover in case the monitor itself has been destroyed: 

a. Press STOP lever switch. 

b. Fill out software trouble report. 

c. Press I/O RESET lever switch. 

d. Go back to step 1 of monitor loading procedure. 

LIST OF STARTING LOCATIONS IN MONITOR 

140 First time - Once-only dialogue, initializes system data storage and I/O devices and moves EXEC 
DDT's symbol table near to the top of existant memory but leaving the last 200 locations free. 

Succeeding Times - initializes I/O devices only. 
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141 Enters EXEC DDT (3000 octal locations) if the operator has indicated that he wants it in the once- 
only code. This is used to debug the monitor and is useful for installations making modifications 
to the monitor for their own special purpose. 

142 Enters SYSMAK routine (36 locations) which moves job 1 down on top of the monitor and moves 
the symbol table to top of memory as set in absolute location 37. This routine is useful to load a 
program which is to replace the monitor, either a new monitor or a nontime-sharing program. 

143 Always examines memories to see which exist, resets system data storage, and kills all jobs. 

144 Dismisses highest interrupt in progress and runs null job. 

145 Reenters once-only dialogue. This may not be possible since the lowest job may be placed on top 
of part of the once-only code. 

146 Starts up system for first time bypassing the once-only code. It is assumed that SYSMAK and 
EXEC DDT are not needed. This is useful if the console Teletype is not working. 

Monitor Storage Layout 

monitor itself 

SYSMAK 

EXEC DDT 

once-only dialogue code 

user jobs may overlay SYSMAK, EXEC DDT, and once-only dialogue code 
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APPENDIX 5 
EXAMPLES OF USING A USER'S CONSOLE 



Underlined text is typed by the user. 

IJQB 

JOB 3 INITIALIZED 

CORE I 

GET SYS PIPl 
JOB SETUP 

START 



MTAO: 


:/W- 




MTAO 


:-PTR: 


/S 


MTAO 


:/W- 




TTYf 


-MTAO: 





(rewind mag tape) 



00010 

OOOaO THIS IS A DEMONSTRATION FILE. 

O0Q30 THESE LINES WERE READ IN FROM THE PAPER TAPE READER. 

00040 HERE IS THE LAST LINE OF THE FILE. 

000 50 

00060 

IC ("CTRL" key and "C" pressed simultaneously) 

ASSIGN MTAO WXYZ 

DEVICE MTAO ASSIGNED 

START 



MTAQz/W*- 

TTY;/N>-WXYZ; 

THIS IS A DEMONSTRATION FILE. 

THESE LINES WERE READ IN FROM THE PAPER TAPE READER. 

HERE IS THE LAST LINE OF THE FILE. 



GORE 10 

8 FREE IK BLOCKS LEFT* NONE ASSIGNED 

KJOB 
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PDP-6 FORTRAN II COMPILER OPERATING INSTRUCTIONS 



The PDP-6 FORTRAN II Compiler contains Iwo 
basic sections: a compiler which generates as- 
sembly code from the FORTRAN source stote- 
ments and an assembler which generates relo- 
catable binary programs. The 22K compiler 
contains both parts in one program. The 9K 
compiler, however, prepares an intermediate 
file for input to the assembler which is a sepa- 
rate program (FOLA). 

COMMAND STRING FOR 22K COMPILER 

The command string is used to specify the input 
and output file designations for the compiler. 
The 22K compiler expects up to two output files 
and one input file. The general form of the 
command string is 

FILEl, FILE2« — FILES 

FILEl will contain the relocatable binary output; 
FILE2 will contain the listing of the compiled 
output (source, assembly, binary, errors), and 
FILES is the source or input file. Each file may 
have one of the following forms: 

DEVICE: 

DEVICE: FILENAME 

DEVICE: FILENAME. EXTENSION 

where DEVICE may be any device mnemonic 
acceptable to the PDP-6 executive system, 
FILENAME may be up to six letters and/or digits, 
and EXTENSION may be up to three letters and/ 
or digits. 



The file name extensions REL and LST are assumed 
for FILEl and FILE2 unless specified otherwise. 

Example: 

PTP: ,DTA3:LIST-« DTAl:SORC.TXT 

If FILEl is not desired, the command string should 
be of the form: 

,FiLE2.« — FILES 

If FILE2 is not desired, either of the following 
command strings is valid: 

FILEl -« FILES 

FILEl, <* — FILES 

If neither output file is desired, the valid com- 
mand strings are: 

4 — FILES 
, 4 FILES 

SWITCHES FOR THE 22K COMPILER 

Switches are letters specifying optional and extra 
functions to be performed by the compi ler . These 
letters may appear within parentheses or after a 
forward slash. Only a single letter may follow a 
slash, while more than one letter may appear 
within parentheses. The switches are as follows: 

K Skip one file on the device (magnetic 
tape only). 

M Do not print storage mop. 

N Do not list errors on Teletype console 
if there is a listing file. 
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APPENDIX 7 
LIMITATIONS ON 9K FORTRAN II COMPILER 

1 . Boolean statements are not allowed. 

2. Use of * in IF statements is not allowed. 
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MULTIPROGRAMMING MANUAL INDEX 



For the convenience of the reader, the letters "A', 'B', and 'C in the Index are arbitrary references to the 
top, middle, and bottom sections, respectively, of the pages. 



9KF2 

(see FORTRAN) 

Address Check, 5-2AB 

Arithmetic Processor Type 166, 1-2B 

ASCII 

(see Data Modes) 
ASCII Line Mode, 4-8A 
ASCII Mode, 4-8A 
ASSIGN, 3-4A 
ATTACH, 3-1 OA 

BAD DIRECTORY, 4-25B 
Batch Processing, 1-lC 
BCP 

(see Batch Processing) 
Binary Mode, 2-4C, 4-8A 
Buffers 

(see I/O Buffers) 
Byte Pointer, 4-1 4B 

(see also I/O Buffer Header) 

CALL Prog. Op., 4-30C 

Card Reader - device service, 4-22C 

Card Reader Type 461 , 1-3A 

CDR 

(see Card Reader) 
CDRSER, A1-3B 
Channel Number, 4-7B 
CLKCSS, A1-2A, A2-1C 
CLOSE Prog. Op., 4-14C 
COMCON, A1-2B 
COMCSS, A1-2B 
COMINI, Al-IB 
Command List 

(see Dump Mode) 
Common User Service Programs 

(see CUSPS) 
Compiler 

(see FORTRAN) 
Console Commands, 3-2B 
Console States, 3-1 B 
Console Teletype 

(see Teletype) 



CONT, 3-8A 
CONTC, 3-9B 
'control' C, 3-1 
Control Character 
(see User State) 
CORE - console command, 3-5B 

- monitor subprogram, Al -1 B 
Core Memory, 2-2C 

Core Memory Type 161C (or 163C), 1-2B 

Core Storage, 2-2C 

CTY 

(see Teletype) 
CUSPS, 2-4C, 3-1 A, 6-1 

- definition, 1-lC 
CUSP tape, 2-4C 

Data Communications System, Type 630 

(see Teletype) 
Data Control Type 1 36, 1 -2B 
Data Modes, 2-4B, 4-7C, 4-16A 

- illegal modes, 4-8C 
Data Sv/itches, 4-32A 
Data Transmission, 4-1 1 B 
DATE - format, 4-31 A 

- in DECtape directory, 4-26B 
DATE Prog. Op., 4-31 A 

DDT, 1-lB, 2-4B, 3-7B, 4-3C, 4-31 B, 4-32C, 
6-1 C 

- characteristics, 6-1 2A 

- console command, 3-8A 

- EXEC DDT, A4-3, A4-6, A4-7 

- loading, 6-1 OC, 6-1 2B 

- monitor debugging, A1-2C 

- Teletype mode, 4-19C 
DDTGT Prog. Op., 4-1 9C 
DDT IN Prog. Op., 4-20A 
DDT OUT Prog. Op., 4-20B 
DDTRL Prog. Op., 4-1 9C 
DEASSIGN, 3-8B 
Debugging, 1-lB 

(see also DDT) 
DECtape Block Loader, A4-1 , A4-2 
DECtape - Colored Labeling Conventions, A4-5 

- device service, 4-23C 

- format, 4-24C 



X-1 



DECtape - RIM Loader, A4-1 , A4-2 

- system files, 2-4C 
DECtape Control Type 551 , 1 -2B 
DESK Calculator, 6-lC, 6-llC 
DETACH, 3-9C 

Detached State, 3-1 B 

(see also User's Console) 
DEVCHR Prog. Op., 4-15C 
Device Characteristics - programmed check, 

4-1 5C 

- summary, 4-1 7 
Device Names, 2-4B 
Directory, 4-1 OB 

- clearing, 4-26C 

- format, 4-25A 
DMP, 3-6C, 3-7B 
DTA 

(see DECtape - device service) 
DTSER2, A1-3A 
Dump Mode, 2-4C, 4-8B 

- command list format, 4-1 3A 

- data transmission, 4-1 3A 

- example, 4-35C 
Dump Records Mode, 4-8B 

Dual DECtape Transport Type 555, 1 -2B 

EDITOR, 6-1 B, 6-9 
End-of-File, 4-14AC 

- magnetic tape, 4-29A 
ENTER Prog. Op., 4-1 OA, 4-26B 
ERRCON, Al-lC 

Error Checking 

(see Status Bits) 
ERROR IN JOB N, 3-2A, 5-1 A 
ERROR IN MONITOR, 5-3B 
Error Messages, 5-1 
Error Recovery Procedures, A4-5 
Examples - I/O Programming, 4-12BC, 4-33 
Exec, 2-2C 

Executive Functions, 2-2C 
EXIT, 3-2A 
EXIT Prog. Op., 4-31 B 



F2 

(see FORTRAN) 
Fast Memory Type 162, 1-2B 
File Generation, 1-lB 
File Initialization, 4-1 OA 
File Name, 2-4B, 4-1 OB 
File Name Extension, 2-4C 
FOLA, 6-1 B, 6-6 



FORLIB, 6-lC, 6-13 

- loading, 6- IOC 
FORTRAN, 6-1 B, 6-6 

- library 
(see FORLIB) 

FUDGE, 6-2A, 6-1 3B 

GET, 3-6C 

GETSTS Prog. Op., 4-1 3B 

Global Symbols 

(see Relocating Linking Loader) 

Idle 

(see Detached State) 
IJOB, 3-3C 

Illegal Instructions, 4-lC, 5-2C 
Illegal Memory Reference, 4-1 B 
ILL Device Data Mode, 4-8C 
ILL DT BLOCK NO., 4-24C 
ILL INST, 5-2C 
ILL MEMREF, 5-1 B 
ILL Prog. Op., 5-2C 
Image Binary Mode, 4-8A 
Image Mode, 2-4C, 4-8A 
INBUFProg. Op., 4-9B 
Incremental Display Type 346, 1-3A 
INIT Prog. Op., 4-7 
INPUT/OUTPUT 

(see I/O) 
INPUT DEVICE X CANNOT DO OUTPUT, 5-3A 
INPUT Prog. Op., 4-11 B 
Inter-console Communications, A4-4 
lOACT, 4-1 4A 
lOBKTL, 4-14A 
lOBOT, 4-30C 

I/O Buffer Header, 4-6A, 4-7BC 
I/O Buffers, 2-4A, 4-4A, 4-5B 

- examples, 4-35 AB 

- initialization, 4-9B 

- sizes, 4-17 
I/O Commands, 2-3A 
lOCON, 4-9A 
lOCONT, Al-lC 
lOCSS, A1-2A 
lODEND, 4-14A 
lODENS, 4-30B 
lODERR, 4-1 3C, 4-30C 
lODTER, 4-1 3C 

I/O Device Allocation, 2-2C 
lOIMPM, 4-1 3C 
lOINIT, 2-3B 
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iOINIl, Al-lC 

IOINI2, A1-2A 

I/O InstrucHons, 4-5 

iOPAR, 4-30B 

lORCK, 4-30A 

I/O Routines, 2-2C 

I/O Service Routines, 2-3A, 4-5, A1-3 

- definition, A1-2A 
lOTEND, 4-30C 

I/O TO UNASSIGNED CHANNEL, 4-9B 
lOWC, 4-9A 

JOBO 

(see Null Job) 
JOB41 , 4-2C 
JOBAC, 4-2B 

JOB CAPACITY EXCEEDED, 3-3AB 
JOBCDP, 4-4B 
JOBDAC, 4-2B 
JOBDAT, 4-2A, 6-1 C, A1-2A, A3-2 

- listing, A3-2 

- loading, 6-1 2C 

Job Data Area, 2-3C, 4-1 C 

JOBDDT, 4-3C, 4-31 B 

JOBFF, 3-7B, 4-4A, 4-7A, 4-9C 

JOBINF, 4-4B 

JOBJDA, 4-3B 

JOBLEV, 4-3A 

JOB N INITIALIZED, 3-lB 

Job Number, 3-1 B, 3-3C 

JOBPC, 4-2C 

JOBPDP, 4-3A 

JOBPOV, 4-3B, 4-31 C 

JOBREL, 4-3A 

Jobs, 1-1 A 

JOBSA, 4-4A, 4-7A, 4-32B 

JOBSAV, 4-3B 

Job Storage Area, 2-3 

JOBSYM, 4-3C, 4-32B 

JOBTEM, 4-4B 

JOBTRP, 4-4B 

JOBUSY, 4-5A 

JOBUUO, 4-2C 

JOBUXT, 4-3A 

KJOB, 3-9A 



Link 

(see DECtape - format) 
LOADER 

(see Relocating Linking Loader) 
LOADER FINISHED, 4-32C 
Loading Monitor, A4-1 — A4^5 
Logical Device Names, 3-4A 
Logical End of Tape - magnetic tape, A4-29A 
LOOKUP Prog. Op., 4-1 OA, 4-26C 
LPT 

(see Line Printer) 
LPTSER, A1-3B 
LST, 2-4C 

(see also Name Extension) 

MAC, 2-4C 

(see also Name Extension) 
MACRO, 6-1 B, 6-8 
Magnetic Tape Control, 1-2B 
Magnetic Tape - density, 4-30B 

- device service, 4-28 

- end-of-file, 4-29A 

- parity, 4-30B 

- tape moving functions, 4-29B 
Memory Protection, 2-3C, 4-1 AB 

(see also Illegal Memory Reference and JOBREL) 
Memory Relocation, 2-3C 
Monitor, 2-2C, 2-3B 
Monitor Commands, 2-2B 

(see also Monitor State) 
MONITOR COMMAND ERROR, 3-2C 
Monitor Starting Locations, A4-6 
Monitor Starting Procedure A4-1 — A4-5 
Monitor State, 3-1 B,2-2B 

(see also User's Console) 
Monitor Storage Layout, A4-7 
Monitor Subprograms, Al-1 
MTA 

(see Magnetic Tape - device service) 
MTAPE Prog. Op., 4-29B 
MTPSER, A1-3B 

Name Extension, 2-4C 

NON EX MEM, 5-1 C 

Nontime-shared Programs, A1-2C, A4-7A 

Null Job, A2-1C 



Library Programs, 2-4C 

LDRBLT Prog. Op., 4-32B 

Line Printer - device service, 4-22B 

Line Printer Type 646, 1-3 A 



ONCE, A1-2C 
Once-Only Dialogue, A4-3 
On-Line Debugging 
(see Dubugging) 
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OPDEFS, A3-1 

Operating InstrucHons for Loading Monitor 

(see Loading Monitor) 
OPR, A4-4A 

OUTBUF Prog, Op., 4-lOA 
OUTPUT DEVICE X CANNOT DO INPUT, 5-3A 
OUTPUT Prog. Op., 4-1 IB 

Paper Tape Punch - device service, 4-21 BC 

Paper Tape Ptinch Type 761, 1-3A 

Paper Tape Reader - device service, 4-20C 

Paper Tape Reader Type 760, 1-2B 

PC EXCEEDS MEM BOUND, 5-lC 

PDL OV, 4-3 IC 

Peripheral Interchange Program 

(see PIP) 
Physical Device Names, 3-4A 
PIP, 6-1 B, 6-3 

- Examples, 6-4C 
PJOB, 3-4A 

Program Interrupt System, 2-3A 
Programmed Operators (Prog. Ops.) 

(see UUOS) 
Programming, 4-1 
PTP 

(see Paper Tape Punch) 
PTPSER, A1-3B 
PTR 

(see Paper Tape Reader) 
Pushdown List, 4-2A, 4-5A, 4-31 C 

(see also JOBPDP and JOBPOV) 

Readin Mode Loader, A4-1, A4-2 
Real Time Processing, 1-lC 
REL, 2-4C 

(see also Name Extension) 
Relatave Address, 4-1 B 
RELEAS Prog. Op., 4-1 5A 
Relocating Linking Loader, 2-4A, 6-1 C, 

6-10 
Relocation, 4-lAB 
RESET Prog. Op., 4-6C 
Resource Allocation 

(see Executive Functions) 
RIMDTA, 6-2A, 6-14 
Ring Buffers 

(see I/O Buffers) 
RUNCSS, Al-lC 

SAVE, 3-7B 
SAVGET, A1-2B 
Scheduling, 2-2C 



Scheduling Algorithm, A2-1 

SCNSER, A1-3A 

SET DDT Prog. Op., 4-3 IB 

SETPOVProg. Op., 4-31 C 

SETSTS Prog. Op., 4-14B 

Software - Hardware Interaction, 2-1 A 

(see also System Block Diagram) 
START, 3-7A 
STARTC, 3-9B 
STATO Prog. Op., 4-13B 
Status Bits, 4-1 3B 

- DECtape, 4-27C 

- magnetic tape, 4-30 
STATZ Prog. Op., 4-1 3B 
Storage Map, 6-1 OB 
SWITCH Prog. Op., 4-32A 
Symbol Table, 2-4A 
Synchronization, 4-1 5B 
SYS, 2-4C 

SYSCON, Al-IB 

SYSCSS, A1-2B 

SYSINI, A1-2C 

SYSMAK, Al -2, A4-6, A4-7 

System Block Diagram, 2-lAB 

System Parameters, A3-3, A3-8 

Teleprinter Type 626, 1-2B 
Teletype, 2-lC 

(see also User's Console) 

- device service, 4-18 
Teletype Scanner, 1-2C 
Teletype Stations, 2-2A 

(see also User Consoles) 
TIMER Prog. Op., 4-32A 
Time-shared Operation, 2-2C 
Time-sharing Hardware, 2-2C 
TOO FEW ARGUMENTS, 3-26 
TTY, 3-3C 

(see also Teletype) 

UGETFProg. Op., 4-26B 
Unused Memory, 2-4A 
USE Bit, 4-6C 
User Mode, 4-1 A 
User State, 2-2B, 3-1 B 

(see also User's Console) 
User's Area, 2-3C, 3-5B 

- definition, 4-1 A 
User's Console, 2-1 C, 3-8C 

(see also Teletype) 
User's Core Memory, 2-3 
Users' Programs, 2-2C 
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USETI Prog. Op., 4-26A 
USETO Prog. Op., 4-26A 
UTPCLR Prog. Op., 4-26 
UUOS, 4-2A, 4-5B 

- FORTRAN definitions, A3-1B 

- Monitor definitions, A3-1A 



WAIT Prog. Op., 4-1 5B 

Write Lock - DECtape, 4-27C 

Write Protect Ring - magnetic tape, 4-30C 

X, 3-3B 
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